ติดตั้งใช้งานบริการ

หากต้องการเตรียมพร้อมสำหรับการติดตั้งใช้งาน HAL คุณสามารถสร้างโค้ดอินเทอร์เฟซ ConfigStore พื้นฐาน แล้วแก้ไขให้ตรงกับความต้องการของคุณ

สร้างโค้ดอินเทอร์เฟซ

หากต้องการสร้างโค้ดบอยเลอร์เพลตสำหรับอินเทอร์เฟซ ให้เรียกใช้ hidl-gen เช่น หากต้องการสร้างโค้ดสำหรับ surfaceflinger ให้ทำดังนี้

hidl-gen -o hardware/interfaces/configstore/1.0/default \
    -Lc++-impl \
    -randroid.hardware:hardware/interfaces \
    -randroid.hidl:system/libhidl/transport \
    android.hardware.config@1.0::ISurfaceFlingerConfigs

แก้ไข Android.mk

จากนั้นแก้ไขไฟล์ Android.mk เพื่อเพิ่มไฟล์การติดตั้งใช้งาน (<modulename>Configs.cpp) ไปยัง LOCAL_SRC_FILES และ เพื่อแมปแฟล็กบิลด์ลงในการกำหนดมาโคร เช่น คุณสามารถแก้ไข surfaceflingerใน hardware/interface/configstore/1.0/default/Android.mkได้ดังนี้

LOCAL_SRC_FILES += SurfaceFlingerConfigs.cpp
ifneq ($(NUM_FRAMEBUFFER_SURFACE_BUFFERS),)
    LOCAL_CFLAGS += -DNUM_FRAMEBUFFER_SURFACE_BUFFERS=$(NUM_FRAMEBUFFER_SURFACE_BUFFERS)
endif

ifeq ($(TARGET_RUNNING_WITHOUT_SYNC_FRAMEWORK),true)
    LOCAL_CFLAGS += -DRUNNING_WITHOUT_SYNC_FRAMEWORK
endif

หาก Android.mk มีบล็อก ifeq-endif หลายบล็อก ให้พิจารณาย้ายโค้ดไปยังไฟล์ใหม่ (เช่น surfaceflinger.mk) จากนั้นรวมไฟล์ดังกล่าวจาก Android.mk

ใช้ฟังก์ชัน

หากต้องการกรอกฟังก์ชันเพื่อใช้ HAL ให้เรียกกลับฟังก์ชัน _hidl_cb ด้วยค่าต่างๆ (ขึ้นอยู่กับแฟล็กบิลด์) เช่น คุณสามารถป้อนฟังก์ชันสำหรับ surfaceflinger in hardware/interfaces/configstore/1.0/default/SurfaceFlingerConfigs.cpp ได้ดังนี้

Return<void> SurfaceFlingerConfigs::numFramebufferSurfaceBuffers(
        numFramebufferSurfaceBuffers_cb _hidl_cb) {
    #if NUM_FRAMEBUFFER_SURFACE_BUFFERS 2
    _hidl_cb(NumBuffers.TWO);
    #else if NUM_FRAMEBUFFER_SURFACE_BUFFERS 3
    _hidl_cb(NumBuffers.THREE);
    #else
    _hidl_cb(NumBuffers.USE_DEFAULT);
    #endif
}

Return<void> SurfaceFlingerConfigs::runWithoutSyncFramework(
        runWithoutSyncFramework_cb _hidl_cb) {
    #ifdef RUNNING_WITHOUT_SYNC_FRAMEWORK
    _hidl_cb({true /* specified */, true /* value */});
    #else
    // when macro not defined, we can give any value to the second argument.
    // It will simply be ignored in the framework side.
    _hidl_cb({false /* specified */, false /* value */});
    #endif
}

ตรวจสอบว่าการติดตั้งใช้งานไม่มีฟังก์ชันที่ชื่อ HIDL_FETCH_interface-name (เช่น HIDL_FETCH_ISurfaceFlingerConfigs) ฟังก์ชันนี้จำเป็นสำหรับ โหมดส่งผ่าน HIDL ซึ่ง configstore ไม่ได้ใช้ (และห้ามใช้) ConfigStore ต้องทำงานในโหมด Binderized เสมอ

ลงทะเบียนเป็นบริการ

สุดท้าย ให้ลงทะเบียนการติดตั้งใช้งานอินเทอร์เฟซทั้งหมดกับconfigstore service เช่น คุณสามารถลงทะเบียนการใช้งาน surfaceflinger ใน hardware/interfaces/configstore/1.0/default/service.cpp ได้

configureRpcThreadpool(maxThreads, true);
sp<ISurfaceFlingerConfigs> surfaceFlingerConfigs = new SurfaceFlingerConfigs;
status_t status = surfaceFlingerConfigs->registerAsService();

sp<IBluetoothConfigs> bluetoothConfigs = new BluetoothConfigs;
status = bluetoothConfigs->registerAsService();

// register more interfaces here
joinRpcThreadpool();

ตรวจสอบว่ามีสิทธิ์ทดลองใช้ก่อนเปิดตัว

เพื่อให้มั่นใจว่าโมดูลเฟรมเวิร์กจะได้รับสิทธิ์เข้าถึงบริการ HAL ก่อนกำหนด บริการ HAL ของการกำหนดค่าควรเริ่มต้นโดยเร็วที่สุดหลังจากที่ hwservicemanager พร้อมใช้งาน เนื่องจากบริการ HAL การกำหนดค่าไม่ได้อ่านไฟล์ภายนอก จึงคาดว่าจะพร้อมใช้งานอย่างรวดเร็วหลังจากเปิดตัว