實作服務

如要準備 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 的函式填入值 英吋 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 一律會在繫結化模式下執行。

註冊為服務

最後,在 configstore 服務。例如,您可以註冊 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 已可使用。由於 Config HAL 服務 這些外部檔案應該很快就會準備就緒。