HAL 可测试性检查

Android 9 供应商测试套件 (VTS) 支持一种运行时方法，可利用设备配置来识别应针对相应设备目标跳过哪些 VTS 测试。

VTS 测试灵活性

自 Android 8.0 开始，所有搭载 Android 8.0 及更高版本的设备都需要完成 VTS 测试。不过，并非任何 VTS 测试都适用于所有设备目标。例如：

如果特定设备不支持某个测试 HAL（例如 IR），则 VTS 无需针对该设备目标运行该 HAL 测试。
如果多个设备共享相同的 SoC 和供应商映像，但具有不同的硬件功能，则 VTS 必须确定应针对特定设备目标运行还是跳过测试。

VTS 测试类型

VTS 包含以下测试类型：

合规性测试可确保框架和供应商分区之间的兼容性。搭载 Android 8.0 或更高版本的设备需要运行（并通过）这些测试。
非合规性测试可帮助供应商提高产品质量（性能/模糊测试等）。这些测试对供应商来说是可选测试。

测试是否属于合规性测试取决于测试属于哪个计划。通过 VTS 计划运行的测试被视为合规性测试。

确定支持的 HAL

VTS 可以根据以下文件确定设备目标是否支持特定 HAL：

/system/compatibility_matrix.xml.用于声明框架所需的 HAL 实例。示例：
```
<hal format="hidl" optional="true">
    <name>android.hardware.vibrator</name>
    <version>1.0-1</version>
    <interface>
       <name>IVibrator</name>
       <instance>default</instance>
    </interface>
</hal>
```
- optional 属性可以指示框架是否严格要求使用相应 HAL。
- 该文件可能针对同一 HAL 包含多个条目（具有相同的名称），但版本和接口有所不同。
- 该文件可能针对同一条目包含多个 version 配置，表明框架支持不同的版本。
- version1.0-1 表示框架最低可支持版本 1.0，并且不需要高于 1.1 的版本。
设备 manifest.xml。用于声明供应商提供的 HAL 实例。示例：
```
<hal format="hidl">
    <name>android.hardware.vibrator</name>
    <transport>hwbinder</transport>
    <version>1.2</version>
    <interface>
        <name>IVibrator</name>
       <instance>default</instance>
    </interface>
</hal>
```
- 该文件可能针对同一 HAL 包含多个条目（具有相同的名称），但版本和接口有所不同。
- 如果该文件针对条目仅包含单个 version 配置，则 version1.2 表示供应商支持从 1.0 到 1.2 的所有版本。
lshal。设备上的一个工具，用于显示已向 hwservicemanager 注册的 HAL 服务的相关运行时信息。示例：
```
android.hardware.vibrator@1.0::IVibrator/default
```
lshal 还会显示具有透传实现（即在设备上具有相应的 -impl.so 文件）的所有 HAL。示例：
```
android.hardware.nfc@1.0::I*/* (/vendor/lib/hw/)
android.hardware.nfc@1.0::I*/* (/vendor/lib64/hw/)
```

合规性测试

对于合规性测试，VTS 依赖供应商清单来确定（和测试）设备提供的所有 HAL 实例。决策流程如下所示：

合规性可测试性检查

图 1. VTS 合规性测试的可测试性检查

非合规性测试

对于非合规性测试，VTS 依赖供应商清单和 lshal 输出来确定（和测试）未在 manifest.xml 文件中声明的实验性 HAL。决策流程如下所示：

非合规性可测试性检查

图 2. VTS 非合规性测试的可测试性检查

查找供应商清单

VTS 按以下顺序在以下位置查找供应商 manifest.xml 文件：

/vendor/etc/vintf/manifest.xml + ODM 清单（如果这两个位置定义了同一 HAL，则 ODM 清单将替换 /vendor/etc/vintf/manifest.xml 中的 HAL）
/vendor/etc/vintf/manifest.xml
ODM manifest.xml 文件，按以下顺序从以下文件加载：
1. /odm/etc/vintf/manifest_$(ro.boot.product.hardware.sku).xml
2. /odm/etc/vintf/manifest.xml
3. /odm/etc/manifest_$(ro.boot.product.hardware.sku).xml
4. /odm/etc/manifest.xml
5. /vendor/manifest.xml

VTS 可测试性检查工具

vts_testibility_checker 是与 VTS 打包在一起的二进制程序，VTS 测试框架会在运行时使用该工具来确定指定的 HAL 测试是否可行。该工具基于 libvintf 来加载和解析供应商清单文件，并实现上一部分中所述的决策流程。

如需使用 vts_testability_check，请执行以下操作：

对于合规性测试：

vts_testability_check -c -b <bitness>  <hal@version>

对于非合规性测试：

vts_testability_check -b <bitness>  <hal@version>

vts_testability_check 的输出采用以下 json 格式：

{testable: <True/False> Instances: <list of instance names of HAL service>}

确定访问过的 HAL

如需确定 VTS 测试会访问哪些 HAL，请确保每个 HAL 测试都使用 VtsHalHidlTargetTestEnvBase 模板注册在测试中访问的 HAL。接下来，VTS 测试框架会在预处理测试时提取已注册的 HAL。

对于合规性测试，您还可以检查 /system/etc/vintf/manifest.xml。如果此文件中定义了 HAL，则 VTS 应测试该 HAL。（对于系统提供的 HAL 服务 [例如 graphics.composer/vr]，/system/manifest.xml 中会声明 HAL）。