Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

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

Uso del cliente

Puedes refactorizar el código compilado de forma condicional para leer valores de forma dinámica desde la interfaz de HAL. Por ejemplo:

#ifdef TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS
// some code fragment
#endif

Luego, el código del framework puede llamar a una función de utilidad adecuada definida en <configstore/Utils.h> según su tipo.

Ejemplo de ConfigStore

En este ejemplo, se muestra la lectura de TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS, definida en HAL de ConfigStore como forceHwcForVirtualDisplays() con el tipo de devolución OptionalBool:

#include <configstore/Utils.h>
using namespace android::hardware::configstore;
using namespace android::hardware::configstore::V1_0;

static bool vsyncPhaseOffsetNs = getBool<ISurfaceFlingerConfigs,
        ISurfaceFlingerConfigs::forceHwcForVirtualDisplays>(false);

La función de utilidad (getBool en el ejemplo anterior) se comunica con el servicio configstore para obtener el identificador del proxy de la función de interfaz y, luego, recupera el valor invocando el identificador a través de HIDL/hwbinder.

Funciones de utilidad

Tipo	Función (se omiten los parámetros de la plantilla)
`OptionalBool`	`bool getBool(const bool defValue)`
`OptionalInt32`	`int32_t getInt32(const int32_t defValue)`
`OptionalUInt32`	`uint32_t getUInt32(const uint32_t defValue)`
`OptionalInt64`	`int64_t getInt64(const int64_t defValue)`
`OptionalUInt64`	`uint64_t getUInt64(const uint64_t defValue)`
`OptionalString`	`std::string getString(const std::string &defValue)`

defValue es un valor predeterminado que se muestra cuando la implementación de HAL no especifica un valor para el elemento de configuración. Cada función toma dos parámetros de plantilla:

I es el nombre de la clase de interfaz.
Func es el puntero de la función miembro para obtener el elemento de configuración.

Debido a que el valor de configuración es de solo lectura y no cambia, la función de utilidad almacena en caché internamente el valor de configuración. Las llamadas posteriores se entregan de manera más eficiente con el valor almacenado en caché en la misma unidad de vinculación.

Usa configstore-utils

El HAL de ConfigStore está diseñado para ser retrocompatible con las actualizaciones de versiones menores, lo que significa que, cuando se revisa el HAL y algún código del framework usa los elementos recién agregados, se puede seguir usando el servicio de ConfigStore con una versión menor anterior en /vendor.

Para garantizar la compatibilidad con versiones futuras, asegúrate de que tu implementación cumpla con los siguientes lineamientos:

Los elementos nuevos usan el valor predeterminado cuando solo está disponible el servicio de la versión anterior. Ejemplo:

service = V1_1::IConfig::getService(); // null if V1_0 is installed
value = DEFAULT_VALUE;
  if(service) {
    value = service->v1_1API(DEFAULT_VALUE);
  }

El cliente usa la primera interfaz que incluyó el elemento ConfigStore. Ejemplo:

V1_1::IConfig::getService()->v1_0API(); // NOT ALLOWED

V1_0::IConfig::getService()->v1_0API(); // OK

El servicio de la versión nueva se puede recuperar para la interfaz de la versión anterior. En el siguiente ejemplo, si la versión instalada es v1_1, se debe mostrar el servicio v1_1 para getService():
```
V1_0::IConfig::getService()->v1_0API();
```
Nota: La implementación actual de AOSP cumple con este requisito.

Cuando las funciones de acceso de la biblioteca configstore-utils se usan para acceder al elemento ConfigStore, la implementación garantiza el punto 1, y los errores del compilador garantizan el punto 2. Por estas razones, te recomendamos que uses configstore-utils siempre que sea posible.