本頁面由 Cloud Translation API 翻譯而成。

新增 ConfigStore 類別和項目

您可以為現有的介面類別新增 ConfigStore 項目 (即介面方法)。如果未定義介面類別，您必須先新增新類別，才能為該類別新增 ConfigStore 項目。本節會使用將 healthd 的 disableInitBlank 設定項目範例新增至 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 的「預設」執行個體名稱。例如在 device/google/marlin/manifest.xml 中：

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

視需要新增加密規則 (也就是用戶端沒有向 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。
注意：使用 -Lc++-impl 執行 hidl-gen，系統會為新新增的介面方法產生骨架程式碼。不過，它也會覆寫所有現有介面方法的實作內容，因此請適當使用 -o 選項。
例如，在 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 中：
```
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 服務，以便日後呼叫已例項化的範本函式。
在 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) \
```