Uso do lado do cliente

Você pode refatorar código compilado condicionalmente para ler valores dinamicamente da interface HAL. Por exemplo:

#ifdef TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS
//some code fragment
#endif

O código da estrutura pode então chamar uma função de utilitário apropriada definida em <configstore/Utils.h> dependendo de seu tipo.

Exemplo de ConfigStore

Este exemplo mostra a leitura TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS , definida no ConfigStore HAL como forceHwcForVirtualDisplays() com tipo de retorno 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);

A função de utilitário ( getBool no exemplo acima) contata o serviço configstore para obter o identificador para o proxy da função de interface e, em seguida, recupera o valor invocando o identificador via HIDL/hwbinder.

Funções de utilidade

<configstore/Utils.h> ( configstore/1.0/include/configstore/Utils.h ) fornece funções de utilitário para cada tipo de retorno primitivo, incluindo Optional[Bool|String|Int32|UInt32|Int64|UInt64] , conforme listado abaixo:

Tipo Função (parâmetros do modelo omitidos)
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 é um valor padrão retornado quando a implementação HAL não especifica um valor para o item de configuração. Cada função recebe dois parâmetros de modelo:

  • I é o nome da classe de interface.
  • Func é o ponteiro de função membro para obter o item de configuração.

Como o valor de configuração é somente leitura e não muda, a função de utilitário armazena em cache internamente o valor de configuração. As chamadas subsequentes são atendidas com mais eficiência usando o valor armazenado em cache na mesma unidade de vinculação.

Usando configstore-utils

O ConfigStore HAL foi projetado para ser compatível com atualizações de versões secundárias, o que significa que quando o HAL é revisado e algum código de estrutura usa os itens recém-introduzidos, o serviço ConfigStore com uma versão secundária mais antiga em /vendor ainda pode ser usado.

Para compatibilidade futura, certifique-se de que sua implementação esteja de acordo com as seguintes diretrizes:

  1. Novos itens usam o valor padrão quando apenas o serviço da versão antiga está disponível. Exemplo:
    service = V1_1::IConfig::getService(); // null if V1_0 is installed
value = DEFAULT_VALUE;
  if(service) {
    value = service->v1_1API(DEFAULT_VALUE);
  }
  2. O cliente usa a primeira interface que inclui o item ConfigStore. Exemplo:
    V1_1::IConfig::getService()->v1_0API(); // NOT ALLOWED

V1_0::IConfig::getService()->v1_0API(); // OK
  3. O serviço da nova versão pode ser recuperado para a interface da versão antiga. No exemplo a seguir, se a versão instalada for v1_1, o serviço v1_1 deve ser retornado para getService() :
    V1_0::IConfig::getService()->v1_0API();

Quando as funções de acesso na biblioteca configstore-utils são usadas para acessar o item ConfigStore, #1 é garantido pela implementação e #2 é garantido por erros do compilador. Por esses motivos, recomendamos usar configstore-utils sempre que possível.