實施服務

為了準備 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並將構建標誌映射到宏定義中。例如,您可以在hardware/interface/configstore/1.0/default/Android.mk中修改surfaceflinger

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函數。例如,您可以在 hardware/interfaces/ surfaceflinger hardware/interfaces/configstore/1.0/default/SurfaceFlingerConfigs.cpp中填充 surfaceflinger 的函數:

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 必須始終以綁定模式運行。

註冊為服務

最後,將所有接口實現註冊到configstore服務。例如,您可以在hardware/interfaces/configstore/1.0/default/service.cpp中註冊surfaceflinger實現:

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 服務不讀取外部文件,因此預計在啟動後會很快準備就緒。