實施服務

為了準備 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/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 服務,config HAL 服務應在hwservicemanager準備就緒後儘早啟動。由於配置 HAL 服務不會讀取外部文件,因此預計啟動後很快就會準備就緒。