A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

Se usó la API de Cloud Translation para traducir esta página.

Agrega clases y elementos de ConfigStore

Puedes agregar nuevos elementos de ConfigStore (es decir, métodos de interfaz) para una clase de interfaz existente. Si la clase de interfaz no está definida, debes agregar una clase nueva antes de poder agregar un elemento ConfigStore para esa clase. En esta sección, se usa el ejemplo de un elemento de configuración disableInitBlank para healthd que se agrega a la clase de interfaz IChargerConfigs.

Agrega clases de interfaz

Si no se define una clase de interfaz para el método de interfaz que deseas agregar, debes agregarla antes de poder agregar los elementos de ConfigStore asociados.

Crea un archivo de interfaz HAL. La versión de ConfigStore es 1.0, por lo que debes definir las interfaces de ConfigStore en hardware/interfaces/configstore/1.0. Por ejemplo, en hardware/interfaces/configstore/1.0/IChargerConfigs.hal:
```
package android.hardware.configstore@1.0;

interface IChargerConfigs {
    // TO-BE-FILLED-BELOW
};
```

Actualiza Android.bp y Android.mk para la biblioteca compartida y los archivos de encabezado de ConfigStore para incluir la nueva HAL de interfaz. Por ejemplo:

hidl-gen -o hardware/interfaces/configstore/1.0/default -Lmakefile -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport android.hardware.configstore@1.0::IChargerConfigs
hidl-gen -o hardware/interfaces/configstore/1.0/default -Landroidbp -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport android.hardware.configstore@1.0::IChargerConfigs

Estos comandos actualizan Android.bp y Android.mk en hardware/interfaces/configstore/1.0.

Genera el stub de C++ para implementar el código del servidor. Por ejemplo:
```
hidl-gen -o hardware/interfaces/configstore/1.0/default -Lc++-impl -randroid.hardware:hardware/interfaces -randroid.hidl:system/libhidl/transport android.hardware.configstore@1.0::IChargerConfigs
```
Con este comando, se crean dos archivos, ChargerConfigs.h y ChargerConfigs.cpp, en hardware/interfaces/configstore/1.0/default.
Abre los archivos de implementación .h y .cpp y quita el código relacionado con la función HIDL_FETCH_name (por ejemplo, HIDL_FETCH_IChargerConfigs). Esta función es necesaria para el modo de transferencia de HIDL, que ConfigStore no usa.

Registra la implementación en el servicio ConfigStore. Por ejemplo, en hardware/interfaces/configstore/1.0/default/service.cpp:

#include <android/hardware/configstore/1.0/IChargerConfigs.h>
#include "ChargerConfigs.h"

using android::hardware::configstore::V1_0::IChargerConfigs;
using android::hardware::configstore::V1_0::implementation::ChargerConfigs;

int main() {
    ... // other code
    sp<IChargerConfigs> chargerConfigs = new ChargerConfigs;
    status = chargerConfigs->registerAsService();
    LOG_ALWAYS_FATAL_IF(status != OK, "Could not register IChargerConfigs");
    ... // other code
}

Modifica el archivo Android.mk para agregar el archivo de implementación (modulenameConfigs.cpp) a LOCAL_SRC_FILES y asignar marcas de compilación a definiciones de macro. Por ejemplo, en hardware/interfaces/configstore/1.0/default/Android.mk:
```
LOCAL_SRC_FILES += ChargerConfigs.cpp

ifeq ($(strip $(BOARD_CHARGER_DISABLE_INIT_BLANK)),true)
LOCAL_CFLAGS += -DCHARGER_DISABLE_INIT_BLANK
endif
```

Agrega una entrada de manifiesto (opcional). Si no existe, se usa el nombre de instancia "predeterminada" de ConfigStore. Por ejemplo, en device/google/marlin/manifest.xml:

    <hal format="hidl">
        <name>android.hardware.configstore</name>
        ...
        <interface>
            <name>IChargerConfigs</name>
            <instance>default</instance>
        </interface>
    </hal>

Agrega la regla de sepolicy si es necesario (es decir, si el cliente no tiene permisos para realizar llamadas de hwbinder a hal_configstore). Por ejemplo, en system/sepolicy/private/healthd.te:
```
... // other rules
binder_call(healthd, hal_configstore)
```

Agrega nuevos elementos de ConfigStore

Para agregar un nuevo elemento ConfigStore, haz lo siguiente:

Abre el archivo HAL y agrega el método de interfaz requerido para el elemento. (Los archivos .hal de ConfigStore residen en hardware/interfaces/configstore/1.0). Por ejemplo, en hardware/interfaces/configstore/1.0/IChargerConfigs.hal:
```
package android.hardware.configstore@1.0;

interface IChargerConfigs {
    ... // Other interfaces
    disableInitBlank() generates(OptionalBool value);
};
```
Implementa el método en los archivos de implementación de HAL de la interfaz correspondiente (.h y .cpp). Coloca las implementaciones predeterminadas en hardware/interfaces/configstore/1.0/default.
Nota: Ejecutar hidl-gen con -Lc++-impl genera código de esqueleto para el método de interfaz agregado recientemente. Sin embargo, también reemplaza las implementaciones de todos los métodos de interfaz existentes, por lo que debes usar la opción -o de forma adecuada.
Por ejemplo, en hardware/interfaces/configstore/1.0/default/ChargerConfigs.h:
```
struct ChargerConfigs : public IChargerConfigs {
    ... // Other interfaces
    Return<void> disableInitBlank(disableInitBlank_cb _hidl_cb) override;
};
```
Y en hardware/interfaces/configstore/1.0/default/ChargerConfigs.cpp:
```
Return<void> ChargerConfigs::disableInitBlank(disableInitBlank_cb _hidl_cb) {
    bool value = false;
#ifdef CHARGER_DISABLE_INIT_BLANK
    value = true;
#endif
    _hidl_cb({true, value});
    return Void();
}
```

Usa elementos de ConfigStore

Para usar un elemento ConfigStore, haz lo siguiente:

Incluye los archivos de encabezado requeridos. Por ejemplo, en system/core/healthd/healthd.cpp:

#include <android/hardware/configstore/1.0/IChargerConfigs.h>
#include <configstore/Utils.h>

Accede al elemento ConfigStore con la función de plantilla adecuada en android.hardware.configstore-utils. Por ejemplo, en system/core/healthd/healthd.cpp:
```
using namespace android::hardware::configstore;
using namespace android::hardware::configstore::V1_0;

static int64_t disableInitBlank = getBool<
        IChargerConfigs,
        &IChargerConfigs::disableInitBlank>(false);
```
En este ejemplo, se recupera el elemento disableInitBlank de ConfigStore y se almacena en una variable (útil cuando se necesita acceder a la variable varias veces). El valor recuperado de ConfigStore se almacena en caché dentro de la función de plantilla creada para que se pueda recuperar rápidamente desde el valor almacenado en caché sin comunicarse con el servicio de ConfigStore para llamadas posteriores a la función de plantilla creada.
Agrega la dependencia en ConfigStore y la biblioteca configstore-utils en Android.mk o Android.bp. Por ejemplo, en system/core/healthd/Android.mk:
```
LOCAL_SHARED_LIBRARIES := \
    android.hardware.configstore@1.0 \
    android.hardware.configstore-utils \
    ... (other libraries) \
```