1. CTS Camera Test 概述

CTS（Compatibility Test Suite，兼容性测试套件）是 Android 生态中确保设备与应用兼容性的核心质量门禁。Camera CTS 测试套件专门针对相机子系统设计，覆盖从 HAL 层到 Framework 层的完整通路。本章将系统阐述 CTS 在 Android 生态中的角色、Camera CTS 测试套件的组成以及测试流程概览，为后续性能优化方向的讨论奠定基础。

1.1 CTS 测试在 Android 生态中的角色

CTS 是 Android 兼容性定义的执行层。Google 通过 CDD（Compatibility Definition Document） 定义硬件与软件的最低要求，CTS 则通过自动化测试验证设备是否满足这些要求。Camera 子系统作为 Android 设备最复杂的硬件模块之一，其 CTS 测试覆盖了图像质量、帧率、分辨率、格式转换、HDR 处理、人脸检测等数十个维度。

CTS 在生态中的三个关键角色：

• 兼容性守门员：确保所有 Android 设备对同一 API 调用返回一致的行为，避免应用碎片化。
• 性能基线定义者：通过测试用例的通过/失败阈值，间接定义了相机子系统的最低性能基线。
• HAL 优化驱动力：CTS 测试结果直接反映 HAL 实现的正确性与效率，是 HAL 优化的首要参考依据。

1.2 Camera CTS 测试套件组成

Camera CTS 测试套件位于 cts/tests/tests/camera/ 目录下，由多个子模块组成。下表列出了核心测试模块及其覆盖范围：

测试套件还包含以下辅助组件：

• 测试资源文件：位于 cts/tests/tests/camera/res/，包含标准测试图像、视频片段、校准数据。
• 测试配置文件：CameraTestConfig.xml，定义测试设备参数、超时阈值、排除规则。
• 测试报告生成器：将原始测试结果转换为 XML/HTML 格式的兼容性报告。

1.3 测试流程概览

Camera CTS 测试的执行流程遵循标准化的阶段划分。理解每个阶段的目标与产出，有助于 HAL 开发者精准定位问题。以下是完整的测试流程：

1. 环境准备阶段：
   • 设备连接至测试主机，启用 USB 调试模式。
   • 安装 CTS 测试 APK 及依赖资源文件。
   • 配置测试参数（如超时时间、排除列表）。
2. 测试执行阶段：
   • 运行 cts-tradefed run cts --module CtsCameraTestCases 启动测试。
   • 测试框架按模块顺序执行用例，每个用例独立初始化 Camera 设备。
   • 实时输出日志到 logcat，记录每个测试步骤的通过/失败状态。
3. 结果收集阶段：
   • 生成 test_result.xml 和 test_result.html 报告。
   • 失败用例附带详细堆栈、HAL 日志、图像 dump（如适用）。
4. 问题分析与修复阶段：
   • 分析失败原因：HAL 实现错误、性能不达标、资源泄漏、时序问题。
   • 修改 HAL 代码后重新运行失败用例，验证修复效果。

1.4 测试结果解读与 HAL 优化切入点

Camera CTS 测试结果以 Pass / Fail / Not Executed 三种状态呈现。对于 HAL 开发者而言，Fail 用例是优化的直接目标。以下表格总结了常见失败类型及其对应的 HAL 优化方向：