您可以為現有的介面類別新增 ConfigStore 項目 (即介面方法)。如果未定義介面類別,您必須先新增新類別,才能為該類別新增 ConfigStore 項目。本節使用 disableInitBlank
設定項目範例,說明如何將 healthd
新增至 IChargerConfigs
介面類別。
新增介面類別
如果您要新增的介面方法未定義介面類別,則必須先新增介面類別,才能新增相關聯的 ConfigStore 項目。
- 建立 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 };
- 請更新 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
。 - 產生 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
。 - 請開啟
.h
和.cpp
實作檔案,然後移除與HIDL_FETCH_name
函式相關的程式碼 (例如HIDL_FETCH_IChargerConfigs
)。這個函式是 HIDL 直通模式所需,但 ConfigStore 不會使用。 - 將實作項目註冊至 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 }
- 修改
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
- (選用) 新增資訊清單項目。如果不存在,則預設為 ConfigStore 的「default」例項名稱。例如,在
device/google/marlin/manifest.xml
中:<hal format="hidl"> <name>android.hardware.configstore</name> ... <interface> <name>IChargerConfigs</name> <instance>default</instance> </interface> </hal>
- 視需要新增 sepolicy 規則 (也就是如果用戶端沒有向
hal_configstore
發出 hwbinder 呼叫的權限)。例如,在system/sepolicy/private/healthd.te
中:... // other rules binder_call(healthd, hal_configstore)
新增 ConfigStore 項目
如要新增 ConfigStore 項目,請按照下列步驟操作:
- 開啟 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); };
- 在對應的介面 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 項目:
- 加入必要的標頭檔案。例如,在
system/core/healthd/healthd.cpp
中:#include <android/hardware/configstore/1.0/IChargerConfigs.h> #include <configstore/Utils.h>
- 在
android.hardware.configstore-utils
中使用適當的範本函式存取 ConfigStore 項目。例如,在system/core/healthd/healthd.cpp
中: 在這個範例中,系統會擷取 ConfigStore 項目using namespace android::hardware::configstore; using namespace android::hardware::configstore::V1_0; static int64_t disableInitBlank = getBool< IChargerConfigs, &IChargerConfigs::disableInitBlank>(false);
disableInitBlank
,並儲存至變數 (如果需要多次存取變數,這項操作就很實用)。從 ConfigStore 擷取的值會快取到例項的範本函式中,以便從快取值中快速擷取值,而無須聯絡 ConfigStore 服務,以便日後呼叫例項化範本函式。 - 在
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) \