客户端使用

您可以重构有条件编译的代码，以从 HAL 接口动态读取值。例如

#ifdef TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS
// some code fragment
#endif

然后，框架代码可以根据其类型调用在 <configstore/Utils.h> 中定义的相应实用程序函数。

ConfigStore 示例

此示例展示了如何读取在 ConfigStore HAL 中定义为 forceHwcForVirtualDisplays() 且返回类型为 OptionalBool 的 TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS

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

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

实用程序函数（上面示例中的 getBool）会联系 configstore 服务以获取接口函数代理的句柄，然后通过 HIDL/hwbinder 调用句柄来检索值。

实用程序函数

<configstore/Utils.h>（configstore/1.0/include/configstore/Utils.h）为每个原始返回类型提供实用程序函数，包括 Optional[Bool|String|Int32|UInt32|Int64|UInt64]，如下所示

类型 函数（省略了模板参数）
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 是指当 HAL 实现未指定配置项的值时返回的默认值。每个函数都采用两个模板参数

  • I 是接口类名称。
  • Func 是用于获取配置项的成员函数指针。

由于配置值是只读的且不会更改，因此实用程序函数会在内部缓存配置值。后续调用会更高效地使用同一链接单元中的缓存值提供服务。

使用 configstore-utils

ConfigStore HAL 被设计为向前兼容次要版本升级。这意味着当 HAL 被修订，并且一些框架代码使用新引入的项目时，位于 /vendor 中具有旧次要版本的 ConfigStore 服务仍然可以使用。

为了向前兼容，请确保您的实现遵循以下准则

  1. 当仅旧版本的服务可用时，新项目使用默认值。例如：
    service = V1_1::IConfig::getService(); // null if V1_0 is installed
value = DEFAULT_VALUE;
  if(service) {
    value = service->v1_1API(DEFAULT_VALUE);
  }
  2. 客户端使用包含 ConfigStore 项目的第一个接口。例如：
    V1_1::IConfig::getService()->v1_0API(); // NOT ALLOWED

V1_0::IConfig::getService()->v1_0API(); // OK
  3. 新版本的服务可以为旧版本的接口检索。在以下示例中，如果安装的版本是 v1_1，则必须为 getService() 返回 v1_1 服务。
    V1_0::IConfig::getService()->v1_0API();

当 configstore-utils 库中的访问函数用于访问 ConfigStore 项目时，#1 由实现保证，#2 由编译器错误保证。由于这些原因，我们强烈建议尽可能使用 configstore-utils。