为了准备 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
函数(以 build 标志为条件)。例如,您可以在 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
准备就绪之后尽早启动。由于 config HAL 服务不会读取外部文件,因此在启动之后预计很快就能准备就绪。