หน้านี้ได้รับการแปลโดย Cloud Translation API

เพิ่มคลาสและรายการ ConfigStore

คุณเพิ่มรายการ ConfigStore ใหม่ (ซึ่งก็คือเมธอดอินเทอร์เฟซ) สำหรับคลาสอินเทอร์เฟซที่มีอยู่ได้ หากไม่ได้กําหนดคลาสอินเทอร์เฟซ คุณต้องเพิ่มคลาสใหม่ก่อนจึงจะเพิ่มรายการ ConfigStore สําหรับคลาสนั้นได้ ส่วนนี้ใช้ตัวอย่างของรายการการกำหนดค่า disableInitBlank สำหรับ healthd ที่เพิ่มลงในคลาสอินเทอร์เฟซ IChargerConfigs

เพิ่มคลาสอินเทอร์เฟซ

หากไม่ได้กําหนดคลาสอินเทอร์เฟซสําหรับเมธอดอินเทอร์เฟซที่ต้องการเพิ่ม คุณต้องเพิ่มคลาสอินเทอร์เฟซก่อนจึงจะเพิ่มรายการ ConfigStore ที่เชื่อมโยงได้

สร้างไฟล์อินเทอร์เฟซ HAL เวอร์ชัน ConfigStore คือ 1.0 ดังนั้นให้กำหนดค่าอินเทอร์เฟซ ConfigStore ใน hardware/interfaces/configstore/1.0 ตัวอย่างเช่น ใน hardware/interfaces/configstore/1.0/IChargerConfigs.hal
```
package android.hardware.configstore@1.0;

interface IChargerConfigs {
    // TO-BE-FILLED-BELOW
};
```
อัปเดต Android.bp และ Android.mk สำหรับไฟล์ส่วนหัวและไลบรารีที่แชร์ของ ConfigStore เพื่อรวม 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
```
คำสั่งเหล่านี้จะอัปเดต Android.bp และ Android.mk ใน hardware/interfaces/configstore/1.0
สร้างสแต็บ 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
```
คำสั่งนี้จะสร้างไฟล์ 2 ไฟล์ ได้แก่ ChargerConfigs.h และ ChargerConfigs.cpp ใน hardware/interfaces/configstore/1.0/default
เปิดไฟล์การใช้งาน .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 และเพื่อแมป Flag การสร้างลงในคําจํากัดความมาโคร เช่นใน 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
```
(ไม่บังคับ) เพิ่มรายการไฟล์ Manifest หากไม่มี ระบบจะใช้ชื่ออินสแตนซ์ "default" ของ ConfigStore เป็นค่าเริ่มต้น ตัวอย่างเช่น ใน device/google/marlin/manifest.xml
```
    <hal format="hidl">
        <name>android.hardware.configstore</name>
        ...
        <interface>
            <name>IChargerConfigs</name>
            <instance>default</instance>
        </interface>
    </hal>
```
เพิ่มกฎ sepolicy หากจำเป็น (กล่าวคือ หากไคลเอ็นต์ไม่มีสิทธิ์เรียกใช้ hwbinder ไปยัง hal_configstore) ตัวอย่างเช่น ใน system/sepolicy/private/healthd.te ให้ทำดังนี้
```
... // other rules
binder_call(healthd, hal_configstore)
```

เพิ่มรายการ ConfigStore ใหม่

วิธีเพิ่มรายการ ConfigStore ใหม่

เปิดไฟล์ HAL และเพิ่มเมธอดอินเทอร์เฟซที่จําเป็นสําหรับรายการ (ไฟล์ .hal สำหรับ ConfigStore จะอยู่ใน 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
หมายเหตุ: การใช้ hidl-gen กับ -Lc++-impl จะสร้างโค้ดโครงสําหรับเมธอดอินเทอร์เฟซที่เพิ่มใหม่ อย่างไรก็ตาม ตัวเลือกนี้จะเขียนทับการใช้งานสำหรับเมธอดอินเทอร์เฟซที่มีอยู่ทั้งหมดด้วย ดังนั้นโปรดใช้ตัวเลือก -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>
```
เข้าถึงรายการ ConfigStore โดยใช้ฟังก์ชันเทมเพลตที่เหมาะสมใน android.hardware.configstore-utils ตัวอย่างเช่น ใน 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 สำหรับการเรียกฟังก์ชันเทมเพลตที่ยืนยันในภายหลัง
เพิ่มการพึ่งพา ConfigStore และconfigstore-utils ไลบรารีใน Android.mk หรือ Android.bp ตัวอย่างเช่น ใน system/core/healthd/Android.mk
```
LOCAL_SHARED_LIBRARIES := \
    android.hardware.configstore@1.0 \
    android.hardware.configstore-utils \
    ... (other libraries) \
```