第28章 Treble与HIDL架构：HAL接口定义、VINTF、Treble兼容性测试

聊到Android底层架构，Treble绝对是个绕不开的大话题。我记得2017年Google刚推出Treble时，我还在为一个厂商的碎片化问题头疼——每次Android大版本升级，HAL层代码几乎要重写一遍。Treble的出现，说白了就是要把硬件厂商和系统框架彻底解耦。

这一章，我会带你深入Treble的核心：HIDL接口定义、VINTF机制，以及兼容性测试。嗯，这些都是我在实际项目中踩过坑的地方。

28.1 Treble架构的前世今生

先说说为什么要有Treble。在Treble之前，Android的HAL（硬件抽象层）是直接链接到framework的。你想想看，每次系统升级，厂商都得重新适配HAL代码。我见过一个项目，光适配一个音频驱动就花了两个月。

Treble的核心思路很简单：把HAL接口标准化，用HIDL定义，然后通过VINTF来声明和匹配。这样一来，framework和vendor分区就彻底分开了。

关键变化：

  • vendor分区：存放厂商的HAL实现，只通过HIDL接口暴露
  • system分区：存放framework代码，只通过HIDL接口调用HAL
  • 两者之间通过binderized HAL通信，不再直接链接

我刚开始接触Treble时，总觉得这不过是多了一层抽象。直到有一次，我在一个老项目上尝试升级Android 9到10，vendor分区几乎没动，只更新了system分区——居然一次就过了兼容性测试。那一刻我才真正体会到Treble的价值。

28.2 HIDL接口定义：从.hal文件说起

HIDL（HAL Interface Definition Language）是Treble的核心。它定义了一套标准的接口描述语言，用来描述HAL应该提供哪些方法、哪些数据类型。

一个典型的HIDL文件长这样：

// IMyHal.hal
package vendor.example.hardware.myhal@1.0;

interface IMyHal {
    /**
     * 初始化硬件设备
     * @return 0表示成功，负数表示错误码
     */
    init() generates (int32_t result);

    /**
     * 设置参数
     * @param key 参数键
     * @param value 参数值
     */
    setParam(string key, string value) generates (int32_t result);

    /**
     * 获取状态
     * @return 当前状态值
     */
    getStatus() generates (int32_t status);
};

这里有几个要点：

  • 包名规则：vendor.厂商名.hardware.模块名@版本号
  • 接口方法：所有方法都必须有返回值，用generates关键字声明
  • 数据类型：支持基本类型、struct、enum、union等

避坑指南：我曾经在定义接口时，把方法参数写成了可选参数。结果编译时死活过不去。HIDL不支持可选参数，所有参数都是必填的。如果你需要默认值，可以在客户端代码里处理。

28.3 HIDL的编译与生成

写完.hal文件后，需要用hidl-gen工具生成C++或Java代码。我个人习惯用C++，因为性能更好。

# 生成C++代码
hidl-gen -o output -L c++-impl \
    -r vendor.example:vendor/example/hardware/interfaces \
    vendor.example.hardware.myhal@1.0

# 生成Android.bp编译配置
hidl-gen -o output -L androidbp \
    -r vendor.example:vendor/example/hardware/interfaces \
    vendor.example.hardware.myhal@1.0

生成的代码结构大致如下：

vendor/example/hardware/interfaces/myhal/1.0/
├── Android.bp
├── IMyHal.hal
├── default/
│   ├── Android.bp
│   ├── MyHal.cpp
│   └── MyHal.h
└── impl/
    ├── Android.bp
    ├── MyHalImpl.cpp
    └── MyHalImpl.h

嗯，这里要注意：default/目录下是接口的默认实现，impl/目录下才是你真正要写的业务逻辑。我刚开始搞混过，结果编译出来的so文件一直报接口不匹配。

28.4 VINTF：接口版本管理的关键

VINTF（Vendor Interface）是Treble的另一个核心组件。它负责声明vendor分区提供了哪些HAL接口，以及这些接口的版本号。

VINTF的配置文件是manifest.xml，放在vendor分区里：

<!-- vendor/etc/vintf/manifest.xml -->
<manifest version="1.0" type="device">
    <hal format="hidl">
        <name>vendor.example.hardware.myhal</name>
        <transport>hwbinder</transport>
        <version>1.0</version>
        <interface>
            <name>IMyHal</name>
            <instance>default</instance>
        </interface>
    </hal>
</manifest>

同时，system分区也有一个compatibility_matrix.xml，声明framework需要哪些HAL接口：

<!-- system/etc/vintf/compatibility_matrix.xml -->
<compatibility-matrix version="1.0" type="framework">
    <hal format="hidl" optional="false">
        <name>vendor.example.hardware.myhal</name>
        <version>1.0</version>
        <interface>
            <name>IMyHal</name>
            <instance>default</instance>
        </interface>
    </hal>
</compatibility-matrix>

重要提醒：VINTF的版本号必须严格匹配。我曾经遇到一个坑：manifest里写的是1.0，但compatibility_matrix里写的是1.1，结果系统启动时直接报"VINTF check failed"。记住，大版本号必须一致，小版本号可以向下兼容。

28.5 Treble兼容性测试（VTS）

Treble兼容性测试（Vendor Test Suite，VTS）是Google用来验证vendor分区是否遵循Treble规范的工具。说白了，就是检查你的HAL实现是否符合HIDL接口定义。

VTS测试用例通常长这样：

// MyHalVtsTest.cpp
#include <vendor/example/hardware/myhal/1.0/IMyHal.h>
#include <VtsHalHidlTargetTestBase.h>

class MyHalVtsTest : public ::testing::VtsHalHidlTargetTestBase {
protected:
    virtual void SetUp() override {
        myHal = IMyHal::getService("default");
        ASSERT_NE(myHal, nullptr);
    }

    sp<IMyHal> myHal;
};

TEST_F(MyHalVtsTest, TestInit) {
    int32_t result;
    myHal->init([&](int32_t r) { result = r; });
    EXPECT_EQ(result, 0);
}

TEST_F(MyHalVtsTest, TestSetParam) {
    int32_t result;
    myHal->setParam("key1", "value1",
        [&](int32_t r) { result = r; });
    EXPECT_EQ(result, 0);
}

运行VTS测试的命令：

# 运行所有VTS测试
vts-tradefed run vts

# 只运行特定模块的测试
vts-tradefed run vts -m VtsHalMyHalV1_0TargetTest

个人经验：VTS测试最容易出问题的地方是接口版本不匹配。我建议你在开发阶段就定期跑VTS，不要等到最后才跑。否则你会发现一堆接口定义问题，改起来很痛苦。

28.6 Treble架构的核心流程图

下面这张图展示了Treble架构的核心数据流：

<svg viewBox="0 0 800 420" style="max-width:100%; height:auto; display:block; margin:16px auto;">
  <defs>
    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="10" refY="3.5" orient="auto">
      <polygon points="0 0, 10 3.5, 0 7" fill="#4A90D9"/>
    </marker>
    <linearGradient id="grad1" x1="0%" y1="0%" x2="100%" y2="100%">
      <stop offset="0%" style="stop-color:#E3F2FD;stop-opacity:1"/>
      <stop offset="100%" style="stop-color:#BBDEFB;stop-opacity:1"/>
    </linearGradient>
    <linearGradient id="grad2" x1="0%" y1="0%" x2="100%" y2="100%">
      <stop offset="0%" style="stop-color:#FFF3E0;stop-opacity:1"/>
      <stop offset="100%" style="stop-color:#FFE0B2;stop-opacity:1"/>
    </linearGradient>
    <linearGradient id="grad3" x1="0%" y1="0%" x2="100%" y2="100%">
      <stop offset="0%" style="stop-color:#E8F5E9;stop-opacity:1"/>
      <stop offset="100%" style="stop-color:#C8E6C9;stop-opacity:1"/>
    </linearGradient>
  </defs>

  <!-- 背景 -->
  <rect x="0" y="0" width="800" height="420" fill="#F5F5F5" rx="8"/>

  <!-- 标题 -->
  <text x="400" y="35" text-anchor="middle" font-size="18" font-weight="bold" fill="#333">Treble架构核心数据流</text>

  <!-- System分区 -->
  <rect x="50" y="60" width="200" height="120" rx="8" fill="url(#grad1)" stroke="#4A90D9" stroke-width="2"/>
  <text x="150" y="95" text-anchor="middle" font-size="14" font-weight="bold" fill="#1565C0">System分区</text>
  <text x="150" y="120" text-anchor="middle" font-size="12" fill="#333">Framework</text>
  <text x="150" y="140" text-anchor="middle" font-size="12" fill="#333">compatibility_matrix.xml</text>
  <text x="150" y="160" text-anchor="middle" font-size="12" fill="#333">HIDL客户端代码</text>

  <!-- Vendor分区 -->
  <rect x="550" y="60" width="200" height="120" rx="8" fill="url(#grad2)" stroke="#FF9800" stroke-width="2"/>
  <text x="650" y="95" text-anchor="middle" font-size="14" font-weight="bold" fill="#E65100">Vendor分区</text>
  <text x="650" y="120" text-anchor="middle" font-size="12" fill="#333">HAL实现代码</text>
  <text x="650" y="140" text-anchor="middle" font-size="12" fill="#333">manifest.xml</text>
  <text x="650" y="160" text-anchor="middle" font-size="12" fill="#333">HIDL服务端代码</text>

  <!-- HIDL接口层 -->
  <rect x="300" y="70" width="200" height="100" rx="8" fill="url(#grad3)" stroke="#4CAF50" stroke-width="2"/>
  <text x="400" y="100" text-anchor="middle" font-size="14" font-weight="bold" fill="#2E7D32">HIDL接口层</text>
  <text x="400" y="125" text-anchor="middle" font-size="12" fill="#333">.hal文件定义</text>
  <text x="400" y="145" text-anchor="middle" font-size="12" fill="#333">hwbinder通信</text>

  <!-- 箭头：System -> HIDL -->
  <line x1="250" y1="120" x2="295" y2="120" stroke="#4A90D9" stroke-width="2" marker-end="url(#arrowhead)"/>
  <text x="272" y="112" text-anchor="middle" font-size="10" fill="#666">调用</text>

  <!-- 箭头：HIDL -> Vendor -->
  <line x1="500" y1="120" x2="545" y2="120" stroke="#FF9800" stroke-width="2" marker-end="url(#arrowhead)"/>
  <text x="522" y="112" text-anchor="middle" font-size="10" fill="#666">实现</text>

  <!-- VINTF检查 -->
  <rect x="300" y="220" width="200" height="60" rx="8" fill="#F3E5F5" stroke="#9C27B0" stroke-width="2"/>
  <text x="400" y="248" text-anchor="middle" font-size="14" font-weight="bold" fill="#6A1B9A">VINTF检查</text>
  <text x="400" y="268" text-anchor="middle" font-size="12" fill="#333">manifest vs matrix</text>

  <!-- 箭头：System -> VINTF -->
  <line x1="150" y1="180" x2="150" y2="250" stroke="#4A90D9" stroke-width="2"/>
  <line x1="150" y1="250" x2="295" y2="250" stroke="#4A90D9" stroke-width="2" marker-end="url(#arrowhead)"/>
  <text x="222" y="242" text-anchor="middle" font-size="10" fill="#666">读取matrix</text>

  <!-- 箭头：Vendor -> VINTF -->
  <line x1="650" y1="180" x2="650" y2="250" stroke="#FF9800" stroke-width="2"/>
  <line x1="650" y1="250" x2="505" y2="250" stroke="#FF9800" stroke-width="2" marker-end="url(#arrowhead)"/>
  <text x="578" y="242" text-anchor="middle" font-size="10" fill="#666">读取manifest</text>

  <!-- VTS测试 -->
  <rect x="300" y="320" width="200" height="60" rx="8" fill="#FFEBEE" stroke="#F44336" stroke-width="2"/>
  <text x="400" y="348" text-anchor="middle" font-size="14" font-weight="bold" fill="#C62828">VTS兼容性测试</text>
  <text x="400" y="368" text-anchor="middle" font-size="12" fill="#333">验证HAL实现正确性</text>

  <!-- 箭头：VINTF -> VTS -->
  <line x1="400" y1="280" x2="400" y2="315" stroke="#9C27B0" stroke-width="2" marker-end="url(#arrowhead)"/>
  <text x="410" y="300" text-anchor="start" font-size="10" fill="#666">通过后</text>
</svg>

28.7 实际项目中的避坑指南

最后，分享几个我在实际项目中遇到的坑：

  1. 接口版本升级：如果你修改了.hal文件，记得更新版本号。我见过有人只改了接口，没改版本号，结果VTS测试一直报错。
  2. hwbinder vs passthrough：HIDL支持两种传输方式。我个人建议用hwbinder，性能更好，而且支持跨进程调用。passthrough模式虽然简单，但容易导致内存泄漏。
  3. VINTF文件位置：manifest.xml必须放在/vendor/etc/vintf/目录下，不能放错位置。我曾经因为放到了/system/etc/vintf/，结果系统启动时根本找不到。
  4. VTS测试超时：有些HAL操作可能耗时较长，VTS测试默认有超时时间。如果你的HAL实现需要较长时间，记得在测试用例里设置合适的超时。

总结一下：Treble架构的核心就是HIDL接口定义 + VINTF版本管理 + VTS兼容性测试。这三者缺一不可。掌握了这些，你就能写出符合Google规范的HAL实现，让Android系统升级变得轻松很多。

公众号:蓝海资料掘金营，微信deep3321
← 上一章 📖 返回目录 下一章 →