Android AIDL HAL工程结构示例

📁 顶层目录

复制代码
testtld/
├── aidl/              ← ① AIDL 接口定义 + 服务端实现
└── test_aidl_hal/     ← ② 客户端测试程序

① aidl/ --- 接口定义 + 服务端

这是最核心的部分,Android HAL 的 "三层结构" 都在这里:

第 1 层:AIDL 接口定义

复制代码
aidl/
├── Android.bp                              ← 构建配置:定义 aidl_interface
└── android/hardware/testtld/
    └── IHelloTest.aidl                     ← ★ 接口定义文件

IHelloTest.aidl 定义了服务接口:

复制代码
@VintfStability
interface IHelloTest {
    int getTestOne(int event, String name);
}

关键点:@VintfStability 表示这是稳定的 Vendor 接口,Android 框架会对其做版本冻结管理。

aidl/Android.bp 把这个接口注册为 android.hardware.testtld,并声明它支持 VINTF、生成 C++/NDK/Java 三种后端代码。frozen: true 表示版本 1 已冻结。

第 1.5 层:API 快照(版本控制)

复制代码
aidl/aidl_api/
├── android.hardware.testtld/1/...     ← 版本 1 的 frozen API 副本
└── android.hardware.testtld/current/... ← 当前开发中的最新版本

Android 的 aidl_interface 编译时自动生成,用来做接口兼容性检查 。你改了 .aidl 文件之后,编译系统会对比 current/ 和已冻结版本,防止破坏兼容性。

第 2 层:服务端实现(default/)

复制代码
aidl/default/
├── Android.bp              ← 构建配置:编译成 cc_binary 服务程序
├── HelloTest.h             ← IHelloTest 的实现类声明
├── HelloTest.cpp           ← IHelloTest 的实现类代码
├── service.cpp             ← ★ 服务入口:main(),注册服务到 vndbinder
├── HelloTest-default.rc    ← init.rc 脚本(开机自启)
└── HelloTest-default.xml   ← VINTF manifest 片段(声明设备有这个 HAL)

各文件的作用:

|-------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|
| HelloTest.h/cpp | 继承 BnHelloTest,实现 getTestOne() 方法。当前实现就打了个 log,返回 2。 |
| service.cpp | 服务进程入口 。用 initWithDriver("/dev/vndbinder") 注册到 vendor binder,然后 AServiceManager_addService() 把服务暴露出去,最后 joinThreadPool() 等待请求。 |
| HelloTest-default.rc | Android init 脚本,告诉系统开机时启动这个服务(class hal) |
| HelloTest-default.xml | VINTF manifest,声明本设备实现了 android.hardware.testtld HAL v1,FQName 是 IHelloTest/default,没有它,系统就不知道 testtld-service 是合法的 HAL |
| Android.bp | 把 service.cpp + HelloTest.cpp 编译成 android.hardware.testtld-service,依赖 android.hardware.testtld-V1-ndk(由上层 aidl_interface 生成的 NDK 绑定库) |


为什么要有HelloTest.h/cpp还要有service.cpp:

1. service.cpp ------ 服务进程的入口

它是整个 HAL 服务的启动器和注册器,负责把一个可执行程序变成系统服务。

  • 启动 Binder 线程池 :通过 ABinderProcess_setThreadPoolMaxThreadCount() 和 ABinderProcess_startThreadPool() 初始化 Binder 通信环境。

  • 创建服务实例 :使用 HelloTest 类(或其他实现类)实例化一个服务对象(通常 ndk::SharedRefBase::make<HelloTest>())。

  • 注册到 ServiceManager :调用 AServiceManager_addService(),把实例和一个服务名(如 "vendor.hello.test.IHello/default")绑定,让客户端能通过名字找到它。

  • 进入循环等待 :调用 ABinderProcess_joinThreadPool() 阻塞等待请求。

没有 service.cpp,服务只是一堆代码,无法独立运行,也无法被系统识别和调用。

2. HelloTest.h/cpp ------ 接口的具体实现

这是业务逻辑的核心,实现了 AIDL 接口定义的方法。

  • 继承生成的 Stub 类 :AIDL 工具会根据 .aidl 文件生成一个抽象类(如 IHello::Stub 或 BnHello),HelloTest 需要继承它并覆写纯虚函数。

  • 编写实际功能 :比如 sayHello() 方法里返回一段字符串,或者操作硬件设备。

  • 与 service.cpp 解耦 :service.cpp 不关心具体怎么实现,只创建 HelloTest 对象并注册;将来如果想替换实现,只需修改 HelloTest.cpp 而无需动服务入口代码。

3. 为什么不能合成一个文件?

当然可以写成单文件,但分开的好处是:

  • 符合单一职责原则:服务注册(进程管理)和业务实现分离,代码更清晰。

  • 便于测试 :可以对 HelloTest 类单独做单元测试,而不需要启动完整的服务进程。

  • 方便扩展 :如果后续要支持多个接口实现(比如一个服务同时实现 IHello 和 IGoodbye),可以在 service.cpp 里注册多个实例,而实现分散在不同文件中。

  • 框架推荐 :Android 官方 HAL 模板(如 hardware/interfaces 下的参考实现)基本都是这种结构。

② test_aidl_hal/ --- 客户端测试

复制代码
test_aidl_hal/
├── Android.bp    ← 构建 cc_binary: test_aidl_hal
└── main.cpp      ← 客户端代码

main.cpp 是服务的消费者,流程:

  1. 通过 AServiceManager_getService() 查找已注册的服务
  2. 拿到 IHelloHal 的 binder 代理
  3. 调用 service->hello_write("hello")

🔗 整体调用链路

复制代码
┌─────────────────────────────────────────────────┐
│  客户端程序 (test_aidl_hal)                       │
│  main.cpp → AServiceManager_getService()         │
│           → IHelloTest::fromBinder()             │
│           → getTestOne()                          │
└────────────────────┬────────────────────────────┘
                     │ vendor binder (/dev/vndbinder)
                     ▼
┌─────────────────────────────────────────────────┐
│  服务程序 (android.hardware.testtld-service)     │
│  service.cpp → AServiceManager_addService()      │
│              → ABinderProcess_joinThreadPool()   │
│  HelloTest.cpp → getTestOne() 具体处理            │
└─────────────────────────────────────────────────┘

一句话总结

这是一个 Android HAL 的 Hello World,展示了:

  1. 用 AIDL 定义一个带 @VintfStability 的硬件接口
  2. 用 C++ 实现服务端,注册到 vendor binder
  3. 写 init.rc + VINTF manifest 让系统自动拉起服务
  4. 写客户端通过 binder 远程调用

结构本身很标准,就是 接口定义(Android.bp + .aidl) → 服务实现(default/) → 客户端(test_aidl_hal/) 三层。客户端代码引用了不同接口名,属于还没对齐的中间状态,不影响理解整体架构。

相关推荐
Wellijohn2 小时前
一个 Android 老兵的十年开源路:从 167 star 的滑动控件,到本地优先的 AI Agent
android·人工智能·开源
好的佩奇7 小时前
Dart 之元数据与注解
android·flutter·dart
三少爷的鞋9 小时前
很多开发者把物理上的分层,当成了架构
android
FungLeo10 小时前
FengCMS · PHP+MySQL 升级实录 · MySQL DDL不能回滚:模型字段结构操作的失败续做
android·mysql·php·工程实践·fengcms
雨白10 小时前
Android 建造者模式实战:从 AlertDialog 源码到 TopBar 的两种实现
android
_祝你今天愉快13 小时前
Android 高级绘制:[五] 贝塞尔曲线与计算规则
android
FungLeo1 天前
FengCMS · PHP+MySQL 升级实录 · 危险默认值之殇:root/123456、认证码 8888 写进配置加载器
android·mysql·php·安全加固·fengcms
yz_aiks1 天前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
booboosui1 天前
编号没变,消息还是来了:Mac 端通知读取漏第二条的原因
android
雨白2 天前
单例设计模式:从 Java/Kotlin 实现到 Android 实战
android