如要準備 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 服務,則設定 HAL 服務應在 hwservicemanager
準備就緒後盡快啟動。由於設定 HAL 服務不會讀取外部檔案,因此應該會在啟動後快速準備就緒。