CTS测试覆盖多Camera场景与HAL稳定性验证 - 第4节

4.1 环境搭建全景概览

CTS（Compatibility Test Suite）测试环境的正确搭建是Camera HAL稳定性验证的基础。一个完整的环境包含四个核心层次：SDK工具链、CTS测试包、物理设备和调试通道。本节将逐一拆解每个环节的配置要点与常见陷阱。

4.2 Android SDK 配置

4.2.1 下载与安装

推荐使用 Android Studio 内置的 SDK Manager 进行安装，或直接下载 Command Line Tools 用于无GUI环境。关键组件版本要求如下：

4.2.2 环境变量配置

将 SDK 工具路径添加到系统 PATH 中，确保终端可直接调用 adb、fastboot 等命令：

# Linux / macOS
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/build-tools/34.0.0
export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin

# Windows (PowerShell)
$env:ANDROID_HOME = "$env:USERPROFILE\Android\Sdk"
$env:Path += ";$env:ANDROID_HOME\platform-tools"
$env:Path += ";$env:ANDROID_HOME\build-tools\34.0.0"

4.3 CTS 工具下载与部署

4.3.1 获取 CTS 包

CTS 测试包从 AOSP 官方仓库 或 Google 兼容性页面 下载。每个 Android 版本对应独立的 CTS 版本：

4.3.2 解压与目录结构

将下载的 zip 包解压到工作目录，建议使用无空格、无中文的路径：

# 解压命令
unzip android-cts-14_r2-linux_x86-arm.zip -d /opt/cts/

# 解压后的核心目录结构
/opt/cts/android-cts/
├── android-cts/
│   ├── testcases/          # 测试用例二进制与配置文件
│   ├── tools/              # 测试执行工具（cts-tradefed）
│   ├── repository/         # 测试计划与结果仓库
│   ├── logs/               # 运行日志输出目录
│   ├── results/            # 测试结果 XML 存放目录
│   └── cts-tradefed        # 主执行脚本
└── android-cts-verifier/   # 手动测试套件（需安装 APK）

4.4 测试设备准备

4.4.1 设备固件要求

CTS 测试对设备固件有严格约束，不满足条件将直接导致测试失败：

• Build 类型： 必须为 userdebug 或 eng 版本，user 版本无法通过 CTS。
• Bootloader： 必须解锁，允许刷写系统分区。
• 系统分区： 必须为 可写 状态，CTS 运行时会推送测试文件到 /data/local/tmp。
• 安全设置： 关闭屏幕锁（PIN/图案/密码），关闭"允许屏幕叠加"。
• 开发者选项： 开启 USB 调试、保持唤醒、不锁定屏幕。

4.4.2 多Camera场景的设备配置

针对 Camera HAL 稳定性测试，设备需具备以下硬件配置：

4.5 adb 调试环境

4.5.1 连接与授权

adb 是 CTS 与设备通信的唯一通道，必须确保稳定可靠：

# 检查设备是否被识别
adb devices -l

# 预期输出（已授权状态）
List of devices attached
ABCDEF1234567890    device product:xxx model:XXX device:XXX transport_id:1

# 若显示 "unauthorized"，需在设备上确认 RSA 指纹授权
# 若显示 "offline"，尝试重新插拔 USB 或重启 adb 服务
adb kill-server
adb start-server

4.5.2 多设备管理

当同时连接多台 DUT 时，需指定设备序列号：

# 列出所有设备
adb devices

# 指定设备执行命令
adb -s ABCDEF1234567890 shell dumpsys media.camera

# 使用环境变量统一指定
export ANDROID_SERIAL=ABCDEF1234567890
adb shell getprop ro.build.fingerprint

4.5.3 网络 adb（无线调试）

对于 Camera 稳定性测试，无线 adb 可避免 USB 线缆对设备摆放的干扰：

# 1. 设备连接 USB 后，开启网络 adb 端口
adb tcpip 5555

# 2. 断开 USB，通过 IP 连接
adb connect 192.168.1.100:5555

# 3. 验证连接状态
adb devices
# 输出：192.168.1.100:5555    device

# 4. 恢复 USB 模式
adb usb

4.6 环境验证清单

在正式执行 CTS 测试前，逐项确认以下环境条件是否满足：

4.7 多Camera场景的专项环境配置

针对 Camera HAL 稳定性验证，还需额外配置以下环境参数：

4.7.1 关闭 Camera 相关系统优化

# 关闭 Camera 服务的内存压缩，避免测试期间被 kill
adb shell setprop persist.camera.force.nonpub 1

# 关闭 HAL 层的低功耗模式
adb shell setprop persist.camera.hal3.enable 1

# 增加 Camera 服务超时时间（毫秒）
adb shell setprop persist.camera.cts.timeout 10000

4.7.2 准备多Camera测试脚本

在 CTS 测试前，建议先运行一个快速的多Camera切换脚本，验证 HAL 层的基本稳定性：

#!/bin/bash
# quick_camera_switch_test.sh
# 快速验证前后摄切换是否会导致 HAL 崩溃

for i in {1..50}; do
  echo "=== Iteration $i ==="
  # 打开后置摄像头
  adb shell am start -a android.media.action.IMAGE_CAPTURE
  sleep 2
  # 切换到前置摄像头
  adb shell input keyevent 21  # 模拟切换按钮（需根据实际 UI 调整）
  sleep 2
  # 关闭相机
  adb shell input keyevent 4   # Back 键
  sleep 1
  # 检查 CameraService 是否存活
  adb shell dumpsys media.camera | grep "CameraService" | grep "pid"
  if [ $? -ne 0 ]; then
    echo "ERROR: CameraService crashed at iteration $i"
    exit 1
  fi
done
echo "All iterations passed."

4.8 环境搭建检查清单（速查表）

完成以上所有步骤后，CTS 测试环境即搭建完毕，可进入下一阶段的测试执行与结果分析。