3. VTS 测试环境搭建：硬件要求、软件环境配置、VTS 测试工具安装与配置

VTS (Vendor Test Suite) 测试环境的正确搭建是进行 HAL 层日志分析与补丁验证的前提。一个标准化的环境能够确保测试结果的可复现性，避免因环境差异导致的误判。本章节将系统阐述 VTS 测试环境的硬件选型、软件栈配置以及核心工具的安装与验证流程。

3.1 硬件环境要求

VTS 测试对硬件有明确的性能与接口要求，错误的硬件配置可能导致测试超时、闪退或结果不可信。下表列出了推荐的最低配置与建议配置：

3.2 软件环境配置

软件环境是 VTS 运行的基石，主要包括操作系统、Java 开发工具包 (JDK)、Python 运行时以及 Android SDK 平台工具。以下步骤基于 Ubuntu 22.04 LTS 进行说明。

3.2.1 操作系统与基础依赖

# 更新包索引并安装基础依赖
sudo apt update
sudo apt install -y git-core gnupg flex bison build-essential \
    zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \
    libncurses5 lib32ncurses5-dev x11proto-core-dev libx11-dev \
    lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig

3.2.2 JDK 与 Python 版本要求

# 安装 OpenJDK 17
sudo apt install -y openjdk-17-jdk

# 安装 Python 3.10 (如系统未自带)
sudo apt install -y python3.10 python3.10-venv

# 下载并配置 Android SDK Platform Tools
wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip
unzip platform-tools-latest-linux.zip -d ~/android-sdk
echo 'export PATH=$PATH:~/android-sdk/platform-tools' >> ~/.bashrc
source ~/.bashrc

# 验证 adb 与 fastboot
adb version
fastboot --version

3.3 VTS 测试工具安装与配置

VTS 测试工具的核心是 TradeFed 测试框架以及对应的 VTS 测试套件。安装方式分为两种：从 AOSP 源码编译获取，或直接下载预编译的 VTS 包。

3.3.1 方式一：从 AOSP 源码编译 (推荐)

此方式适用于需要深度定制测试或进行 HAL 层补丁验证的场景。

# 1. 初始化 AOSP 仓库 (以 android-14.0.0_r35 为例)
mkdir ~/aosp && cd ~/aosp
repo init -u https://android.googlesource.com/platform/manifest -b android-14.0.0_r35
repo sync -j$(nproc)

# 2. 编译 VTS 测试套件
source build/envsetup.sh
lunch aosp_arm64-userdebug
make vts -j$(nproc)

# 3. 编译产物路径
# out/host/linux-x86/vts/android-vts.zip

3.3.2 方式二：下载预编译 VTS 包 (快速)

适用于仅需执行标准兼容性测试的场景。

# 从 Google 官方源下载最新 VTS 包
wget https://dl.google.com/android/test/vts/android-vts.zip

# 解压到指定目录
unzip android-vts.zip -d ~/vts-tools

# 配置环境变量
echo 'export VTS_ROOT=~/vts-tools/android-vts' >> ~/.bashrc
echo 'export PATH=$PATH:$VTS_ROOT/tools' >> ~/.bashrc
source ~/.bashrc

3.3.3 验证安装

安装完成后，通过以下命令验证 VTS 工具链是否就绪：

# 检查 TradeFed 版本
vts-tradefed help

# 列出所有可用的 VTS 测试模块
vts-tradefed list modules

# 快速运行一个简单的 VTS 测试 (需连接 DUT)
vts-tradefed run vts -m VtsHalAudioCoreV7_0TargetTest

3.4 环境验证清单

在开始 VTS 测试之前，建议逐项核对以下清单，确保环境无遗漏：

• ✅ 硬件检查： 确认 DUT 已解锁 bootloader，USB 调试已开启，且主机 USB 端口供电稳定。
• ✅ 网络连通性： 主机能够访问 dl.google.com 和 android.googlesource.com (或配置了国内镜像)。
• ✅ 依赖完整性： 运行 vts-tradefed help 无报错，且能列出测试模块。
• ✅ 设备识别： 执行 adb devices -l 显示 DUT 状态为 device，且 product/variant 信息正确。
• ✅ 存储空间： 确认 df -h 显示剩余空间 ≥ 50 GB (用于测试日志与临时文件)。