添加 ConfigStore 类和项

使用合集保持井井有条 根据您的偏好保存内容并进行分类。

您可以为现有的接口类添加新的 ConfigStore 项（即接口方法）。如果未定义接口类，您必须先添加新类，然后才能为该类添加 ConfigStore 项。本部分以向 IChargerConfigs 接口类添加用于 healthd 的 disableInitBlank 配置项为例。

添加接口类

如果未为要添加的接口方法定义接口类，您必须先添加接口类，然后才能添加关联的 ConfigStore 项。

1. 创建 HAL 接口文件。ConfigStore 版本为 1.0，因此请在 hardware/interfaces/configstore/1.0 中定义 ConfigStore 接口。例如，在 hardware/interfaces/configstore/1.0/IChargerConfigs.hal 中

   package android.hardware.configstore@1.0;
   
   interface IChargerConfigs {
       // TO-BE-FILLED-BELOW
   };
   

2. 更新 ConfigStore 共享库和头文件的 Android.bp 和 Android.mk，以包含新的接口 HAL。例如

   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
   

   这些命令会更新 hardware/interfaces/configstore/1.0 中的 Android.bp 和 Android.mk。
3. 为实现服务器代码生成 C++ 桩代码。例如

   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
   

   此命令会在 hardware/interfaces/configstore/1.0/default 中创建两个文件：ChargerConfigs.h 和 ChargerConfigs.cpp。
4. 打开 .h 和 .cpp 实现文件，并移除与函数 HIDL_FETCH_name（例如，HIDL_FETCH_IChargerConfigs）相关的代码。HIDL 直通模式需要此函数，但 ConfigStore 未使用该模式。
5. 将实现注册到 ConfigStore 服务。例如，在 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
   }
   

6. 修改 Android.mk 文件，以将实现文件（modulenameConfigs.cpp）添加到 LOCAL_SRC_FILES，并将构建标志映射到宏定义。例如，在 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
   

7. （可选）添加清单条目。如果该条目不存在，则默认使用 ConfigStore 的“default”实例名称。例如，在 device/google/marlin/manifest.xml 中

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

8. 如果需要，添加 sepolicy 规则（即，如果客户端没有权限对 hal_configstore 进行 hwbinder 调用）。例如，在 system/sepolicy/private/healthd.te 中

   ... // other rules
   binder_call(healthd, hal_configstore)
   

添加新的 ConfigStore 项

要添加新的 ConfigStore 项，请执行以下操作：

1. 打开 HAL 文件，并为该项添加所需的接口方法。（ConfigStore 的 .hal 文件位于 hardware/interfaces/configstore/1.0 中。）例如，在 hardware/interfaces/configstore/1.0/IChargerConfigs.hal 中

   package android.hardware.configstore@1.0;
   
   interface IChargerConfigs {
       ... // Other interfaces
       disableInitBlank() generates(OptionalBool value);
   };
   

2. 在相应的接口 HAL 实现文件（.h 和 .cpp）中实现该方法。将默认实现放在 hardware/interfaces/configstore/1.0/default 中。例如，在 hardware/interfaces/configstore/1.0/default/ChargerConfigs.h 中

   struct ChargerConfigs : public IChargerConfigs {
       ... // Other interfaces
       Return<void> disableInitBlank(disableInitBlank_cb _hidl_cb) override;
   };
   

   以及在 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();
   }
   

使用 ConfigStore 项

要使用 ConfigStore 项，请执行以下操作：

1. 包含所需的头文件。例如，在 system/core/healthd/healthd.cpp 中

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

2. 使用 android.hardware.configstore-utils 中适当的模板函数访问 ConfigStore 项。例如，在 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);
   

   在此示例中，ConfigStore 项 disableInitBlank 被检索并存储到一个变量中（当需要多次访问该变量时非常有用）。从 ConfigStore 检索的值缓存在实例化的模板函数内部，以便可以从缓存值快速检索该值，而无需为了后续调用实例化的模板函数而联系 ConfigStore 服务。
3. 在 Android.mk 或 Android.bp 中添加对 ConfigStore 和 configstore-utils 库的依赖项。例如，在 system/core/healthd/Android.mk 中

   LOCAL_SHARED_LIBRARIES := \
       android.hardware.configstore@1.0 \
       android.hardware.configstore-utils \
       ... (other libraries) \