2. 测试环境搭建：Android CTS环境要求、高通平台专用配置、adb与fastboot工具链准备

搭建一个符合高通Camera项目兼容性验证要求的CTS测试环境，是后续故障排查的基础。本章从硬件资源、软件版本、高通专用配置以及工具链四个维度，梳理环境搭建的关键步骤与避坑要点。

2.1 Android CTS环境硬件与软件基线

CTS（Compatibility Test Suite）对测试主机与设备有明确的基线要求，偏离基线可能导致测试结果不可复现或误判。

2.2 高通平台专用配置

高通平台的CTS测试除了标准CTS流程外，还需要额外配置HAL层接口、权限白名单以及特定的系统属性。以下配置项直接影响Camera相关测试用例的通过率。

2.2.1 系统属性配置

在设备端通过 adb shell setprop 或写入 build.prop 的方式，确保以下属性生效：

# 启用Camera HAL3接口（必须）
persist.vendor.camera.HAL3.enabled=1

# 关闭Camera服务降级（避免CTS误判）
persist.vendor.camera.disable_zsl_mode=0

# 设置CTS测试专用权限白名单
persist.vendor.camera.cts_whitelist=1

# 高通平台专用：强制使用原生HAL实现
persist.vendor.camera.force_native_hal=1

2.2.2 SELinux策略与权限

CTS测试中Camera相关用例需要访问 /dev/video*、/data/misc/camera 以及 /vendor/lib/hw/camera.*.so。高通平台建议在 sepolicy 中预置以下规则：

# 允许CTS测试进程访问Camera设备节点
allow cts_test camera_device:chr_file rw_file_perms;
allow cts_test camera_prop:property_service set;

# 允许读取Camera HAL库
allow cts_test hal_camera:file read;

# 高通专用：允许访问ISP统计节点
allow cts_test msm_isp:file rw_file_perms;

2.3 adb与fastboot工具链准备

adb和fastboot是CTS测试中最频繁使用的工具，版本不匹配或路径混乱会导致设备识别失败、刷机中断、日志抓取不全等问题。

2.3.1 工具版本要求

2.3.2 环境变量配置

将adb和fastboot所在目录添加到 PATH，并确保优先级高于系统自带的旧版本：

# 编辑 ~/.bashrc 或 ~/.zshrc
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$ANDROID_HOME/platform-tools:$PATH
export PATH=$ANDROID_HOME/tools:$PATH
export PATH=$ANDROID_HOME/tools/bin:$PATH

# 立即生效
source ~/.bashrc

# 验证版本
adb --version
fastboot --version

2.3.3 设备连接与授权

高通Camera项目在CTS测试前，必须确保设备已正确授权并处于可识别状态：

1. 使用USB直连主机，避免通过HUB或延长线。
2. 在设备上开启 开发者选项 和 USB调试。
3. 执行 adb devices，确认设备状态为 device 而非 unauthorized。
4. 若设备为user版本，需先执行 adb root 确认是否支持root权限；若不支持，需刷入userdebug或eng版本。
5. 执行 adb shell getprop ro.build.type 确认构建类型为 userdebug 或 eng。

2.4 环境验证流程图

以下SVG图展示了从主机准备到设备验证的完整流程，帮助快速定位环境搭建中的断点。

2.5 常见环境问题速查表