1. CTS 概述：定义、生态角色与 Camera HAL 的关系
CTS（Compatibility Test Suite，兼容性测试套件）是 Android 生态中用于验证设备实现是否符合 Android 兼容性定义文件（CDD）要求的官方测试工具集。对于 Camera HAL 开发者而言，CTS 不仅是质量门禁，更是理解 Android 相机架构与行为规范的权威参考。
1.1 CTS 的定义
CTS 是一套由 Google 维护的自动化测试程序集合，运行在 Android 设备上，通过执行数千个测试用例来检查设备的行为、API 实现、性能指标和权限模型是否与 Android 平台版本兼容。CTS 覆盖了从应用框架层到硬件抽象层（HAL）的完整软件栈。
核心要点：CTS 不是性能测试工具，而是兼容性验证工具。它确保同一版本的 Android 应用在所有通过 CTS 认证的设备上具有一致的行为表现。
| 组件 | 说明 | 与 Camera 相关性 |
|---|---|---|
| cts-tradefed | CTS 测试执行框架，负责调度、重试、报告生成 | 运行 Camera 测试模块的入口 |
| android-cts | 核心测试用例 APK，包含约 2000+ 测试项 | Camera API2/API1 测试、权限测试、多摄像头测试 |
| android-cts-verifier | 需要人工交互的验证测试，含相机预览、闪光灯等 | 手动验证 Camera 硬件功能 |
| cts-media | 媒体编解码与相机录制测试资源 | 视频录制格式、帧率、分辨率验证 |
1.2 CTS 在 Android 生态中的作用
CTS 在 Android 生态中扮演着质量守门人的角色，其作用贯穿设备开发、认证和用户使用的全生命周期。
- 生态一致性保障：确保所有 Android 设备（手机、平板、汽车、IoT）对同一应用提供相同的 API 行为，避免碎片化。
- 应用开发者信任：开发者可以依赖 CTS 认证设备上的 API 实现，无需为不同厂商做特殊适配。
- 厂商准入标准：设备必须通过 CTS 认证才能预装 Google 移动服务（GMS），这是设备进入全球市场的必要条件。
- 版本升级验证：Android 大版本升级（如 Android 13 → 14）时，CTS 是验证新 API 和废弃 API 行为变更的核心手段。
开发者视角：Camera HAL 开发中，CTS 失败往往意味着 HAL 实现与 Android 框架的预期行为不一致。修复 CTS 失败项是 HAL 开发中最常见、最直接的调试任务。
1.3 CTS 与 Camera HAL 的关系
Camera HAL（Hardware Abstraction Layer）是 Android 相机框架与底层硬件之间的桥梁。CTS 与 Camera HAL 的关系可以概括为规范与实现、测试与被测试的双重关系。
1.3.1 关系矩阵
| 维度 | CTS 角色 | Camera HAL 角色 | 典型测试项 |
|---|---|---|---|
| 接口一致性 | 验证 HAL 接口方法签名、返回值类型 | 实现 camera_device_t、camera3_device_ops_t 等结构体 | testCameraDeviceOpenClose |
| 行为正确性 | 检查 HAL 在特定场景下的行为是否符合 CDD | 处理 configure_streams、process_capture_request 等调用 | testCameraPreviewStops |
| 性能指标 | 测量帧率、延迟、分辨率切换时间 | 保证 buffer 投递速度、ISP 处理延迟 | testCameraCapturePerformance |
| 错误处理 | 注入异常场景，验证 HAL 的容错能力 | 返回正确错误码、释放资源、避免死锁 | testCameraErrorCallback |
| 多摄像头 | 验证逻辑摄像头、物理摄像头配置 | 实现 multi-camera 同步、物理 ID 映射 | testLogicalCamera |
1.3.2 CTS 失败对 Camera HAL 开发的影响
在 Camera HAL 开发过程中，CTS 失败是最常见的质量反馈信号。根据 Android 兼容性认证流程，Camera 模块的 CTS 失败项会直接导致设备无法获得 GMS 认证。以下是 CTS 失败对 HAL 开发的典型影响路径：
- 接口实现错误：HAL 未正确实现某个 mandatory 接口（如 get_metadata_vendor_tag_ops），CTS 直接报错。
- 行为偏离规范：HAL 在特定场景下返回了不符合 CDD 要求的结果（如预览帧率低于 15fps），CTS 标记为失败。
- 资源泄漏：HAL 在反复打开/关闭摄像头时未正确释放内存或 fd，CTS 压力测试触发 OOM 或 ANR。
- 多摄像头同步问题：逻辑摄像头下的物理摄像头流配置不一致，CTS 多摄像头测试失败。
常见误区：部分 HAL 开发者认为 CTS 失败可以通过修改测试用例或绕过检查来规避。实际上，CTS 测试用例由 Google 官方维护，修改测试用例无法通过认证审核。正确的做法是修复 HAL 实现以符合 CTS 预期。
1.4 Camera HAL 开发中的 CTS 测试分类
在 Camera HAL 开发实践中，CTS 测试可以按照测试对象和测试深度分为以下三类：
| 分类 | 测试模块 | 覆盖内容 | 典型用例数 |
|---|---|---|---|
| 基础功能测试 | android.hardware.camera2.cts | 摄像头打开/关闭、预览、拍照、录像、闪光灯 | ~400 |
| 扩展功能测试 | android.hardware.camera2.cts.extension | HDR、夜景、人像、多摄像头、逻辑摄像头 | ~200 |
| 性能与压力测试 | android.hardware.camera2.cts.perf | 帧率稳定性、分辨率切换延迟、连续拍摄吞吐量 | ~100 |
开发建议：在 HAL 开发初期，建议优先运行基础功能测试模块，确保 open/close、preview、capture 等核心流程通过。这些测试项覆盖了 HAL 生命周期管理中最容易出错的环节。