创建 HAL 接口

您必须使用 HIDL 来描述用于对框架进行条件式编译的所有 build 标志。相关 build 标志必须分组并包含在单个 .hal 文件中。使用 HIDL 指定配置项具有以下优势：

  • 可实施版本控制（为了添加新配置项，供应商/OEM 必须明确扩展 HAL）
  • 记录详尽
  • 可使用 SELinux 实现访问控制
  • 可通过供应商测试套件对配置项进行健全性检查（范围检查、各项内容之间的相互依赖性检查等）
  • 在 C++ 和 Java 中自动生成 API

确定框架使用的 build 标记

首先，请确定用于对框架进行条件式编译的 build 配置，然后舍弃过时的配置，缩小 build 标志集的范围。例如，下列 build 标志集已确定用于 surfaceflinger：

  • TARGET_USES_HWC2
  • TARGET_BOARD_PLATFORM
  • TARGET_DISABLE_TRIPLE_BUFFERING
  • TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS
  • NUM_FRAMEBUFFER_SURFACE_BUFFERS
  • TARGET_RUNNING_WITHOUT_SYNC_FRAMEWORK
  • VSYNC_EVENT_PHASE_OFFSET_NS
  • SF_VSYNC_EVENT_PHASE_OFFSET_NS
  • PRESENT_TIME_OFFSET_FROM_VSYNC_NS
  • MAX_VIRTUAL_DISPLAY_DIMENSION

创建 HAL 接口

子系统的 build 配置是通过 HAL 接口访问的，而用于提供配置值的接口会在 HAL 软件包 android.hardware.configstore（目前为 1.0 版）中进行分组。例如，如需为 surfaceflinger 创建 HAL 接口文件，请在 hardware/interfaces/configstore/1.0/ISurfaceFlingerConfigs.hal 中运行以下命令： 

package android.hardware.configstore@1.0;

interface ISurfaceFlingerConfigs {
    // TO-BE-FILLED-BELOW
};

创建 .hal 文件后，请运行 hardware/interfaces/update-makefiles.sh，将新的 .hal 文件添加到 Android.bp 和 Android.mk 文件中。

为 build 标记添加函数

对于每个 build 标志，请向相应接口各添加一个新函数。例如，在 hardware/interfaces/configstore/1.0/ISurfaceFlingerConfigs.hal 中： 

interface ISurfaceFlingerConfigs {
    disableTripleBuffering() generates(OptionalBool ret);
    forceHwcForVirtualDisplays() generates(OptionalBool ret);
    enum NumBuffers: uint8_t {
        USE_DEFAULT = 0,
        TWO = 2,
        THREE = 3,
    };
    numFramebufferSurfaceBuffers() generates(NumBuffers ret);
    runWithoutSyncFramework() generates(OptionalBool ret);
    vsyncEventPhaseOffsetNs generates (OptionalUInt64 ret);
    presentTimeOffsetFromSyncNs generates (OptionalUInt64 ret);
    maxVirtualDisplayDimension() generates(OptionalInt32 ret);
};

添加函数时，请注意以下事项：

  • 采用简洁的名称。请避免将 makefile 变量名称转换为函数名称，并切记 TARGET_ 和 BOARD_ 前缀不再是必需的。
  • 添加注释。帮助开发者了解配置项的用途，配置项如何改变框架行为、有效值以及其他相关信息。

函数返回类型可以是 Optional[Bool|String|Int32|UInt32|Int64|UInt64]。类型会在同一目录中的 types.hal 中进行定义，并使用字段（可表明原始值是否是由 HAL 指定）来封装原始值；如果原始值不是由 HAL 指定，则使用默认值。

struct OptionalString {
    bool specified;
    string value;
};

在适当的情况下，请定义最能代表配置项类型的枚举，并将该枚举用作返回类型。在上述示例中，NumBuffers 枚举会被定义为限制有效值的数量。在定义此类自定义数据类型时，请添加字段或枚举值（例如 USE_DEFAULT）来表示该值是否由 HAL 指定。

在 HIDL 中，单个 build 标志并不一定要变成单个函数。模块所有者也可以将密切相关的 build 标志汇总为一个结构体，并通过某个函数返回该结构体（这样做可以减少函数调用的次数）。

例如，用于在 hardware/interfaces/configstore/1.0/ISurfaceFlingerConfigs.hal 中将两个 build 标志汇总到单个结构体的选项如下：

 interface ISurfaceFlingerConfigs {
    // other functions here
    struct SyncConfigs {
        OptionalInt64 vsyncEventPhaseoffsetNs;
        OptionalInt64 presentTimeoffsetFromSyncNs;
    };
    getSyncConfigs() generates (SyncConfigs ret);
    // other functions here
};

单个 HAL 函数的替代函数

作为针对所有 build 标志使用单个 HAL 函数的替代函数，HAL 接口还提供了 getBoolean(string key) 和 getInteger(string key) 等简单函数。实际的 key=value 对会存储在单独的文件中，而 HAL 服务会通过读取/解析这些文件来提供值。

虽然这种方法很容易定义，但它不具备 HIDL 提供的优势（强制实施版本控制、便于记录、实现访问控制），因此不推荐使用。

单个接口与多个接口

面向配置项设计的 HAL 接口提供了以下两种选择：

  • 单个接口；涵盖所有配置项
  • 多个接口；每个接口分别涵盖一组相关配置项

单个接口更易于使用，但随着更多的配置项添加到单个文件中，单个接口可能会越来越难以维护。此外，由于访问控制不够精细，获得接口访问权限的进程可能会读取所有配置项（无法授予对部分配置项的访问权限）。此外，如果未授予访问权限，则无法读取任何配置项。

由于存在这些问题，Android 会针对一组相关配置项将多个接口与单个 HAL 接口搭配使用。例如，对 surfaceflinger 相关配置项使用 ISurfaceflingerConfigs，对蓝牙相关配置项使用 IBluetoothConfigs 等等。