2. HIDL 接口基础：定义文件语法、服务绑定与工具链

HIDL（HAL Interface Definition Language）是 Android 8.0 之后用于 HAL 与 Framework 通信的核心 IPC 机制。与传统的 legacy HAL 不同，HIDL 强制使用接口定义文件（.hal）来描述服务端与客户端之间的契约，并通过 hidl-gen 工具自动生成 C++/Java 绑定代码。本章从语法、绑定流程和工具使用三个维度，建立 HIDL 接口的工程化认知。

2.1 HIDL 定义文件（.hal）语法

.hal 文件使用类似 C++ 的语法，但增加了包名、接口版本、单向/双向调用等语义。一个典型的 Camera HAL 接口文件结构如下：

// types.hal
package android.hardware.camera@3.4;

enum CameraStatus : int32_t {
    OK = 0,
    ERROR = -1,
    DEVICE_DISCONNECTED = -2
};

struct CameraMetadata {
    int32_t tag;
    vec<uint8_t> data;
};

// ICameraDevice.hal
package android.hardware.camera@3.4;

interface ICameraDevice {
    open() generates (CameraStatus status);
    configureStreams(vec<Stream> streams) generates (CameraStatus status, vec<Stream> configuredStreams);
    processCaptureRequest(CaptureRequest request) generates (CameraStatus status);
    close();
};

2.2 服务端与客户端绑定机制

HIDL 服务端通过 hwservicemanager 注册服务，客户端通过服务名查找并绑定。绑定过程涉及三个角色：

• 服务端（HAL Service）：实现 .hal 接口，调用 registerAsService() 注册到 hwservicemanager。
• hwservicemanager：系统级服务注册中心，维护服务名到 Binder 句柄的映射。
• 客户端（Framework/CameraService）：通过 ICameraDevice::getService() 获取服务代理，发起 IPC 调用。

2.3 hidl-gen 工具使用

hidl-gen 是 HIDL 接口的代码生成器，负责将 .hal 文件转换为 C++ 或 Java 绑定代码。其核心工作流程如下：

1. 解析 .hal 文件：读取接口定义，构建抽象语法树（AST）。
2. 生成接口头文件：生成 BnHw*（服务端基类）和 BpHw*（客户端代理）头文件。
3. 生成实现桩代码：生成 HwBinder 传输层代码，处理序列化/反序列化。
4. 生成类型定义：为 struct、enum、union 生成跨进程兼容的类型。

# 基本命令格式
hidl-gen -o <output_path> -L <language> -r <root_package> <package>@<version>::<interface>

# 示例：生成 Camera HAL 3.4 的 C++ 绑定代码
hidl-gen -o ./out -L c++ -r android.hardware:hardware/interfaces \
    android.hardware.camera@3.4::ICameraDevice

# 生成 Java 绑定代码（用于 Framework 端）
hidl-gen -o ./out -L java -r android.hardware:hardware/interfaces \
    android.hardware.camera@3.4::ICameraDevice

# 生成所有依赖接口（包括 types.hal）
hidl-gen -o ./out -L c++ -r android.hardware:hardware/interfaces \
    android.hardware.camera@3.4

2.4 接口版本管理与兼容性

HIDL 接口通过 @major.minor 版本号管理兼容性。版本升级规则如下：

• Minor 版本升级：向后兼容，只能新增方法或类型，不能修改已有接口。
• Major 版本升级：不兼容，可以修改或删除已有接口，需要同时维护两个版本的实现。