CTS Camera Test失败分析与HAL适配修复 - 第1节

1.1 什么是 CTS

CTS（Compatibility Test Suite，兼容性测试套件）是 Google 为 Android 生态系统设计的一套自动化测试工具集。它的核心目标是确保所有 Android 设备（手机、平板、电视、车载等）在应用兼容性、系统行为、API 实现上保持一致，从而维护“一次开发，多设备运行”的生态承诺。

CTS 在 Android 生态中的角色

CTS 处于 Android 生态治理的核心位置，其作用贯穿设备开发、认证、发布全流程：

• 生态守门人： 只有通过 CTS 认证的设备，才有权预装 Google 移动服务（GMS，如 Google Play、Gmail、Maps）。
• 应用开发者保障： 确保应用在不同厂商设备上调用同一 API 时，获得一致的行为和返回值。
• 厂商适配标尺： 为芯片厂商（Qualcomm、MTK、展锐）和 OEM 提供明确的 HAL 实现规范，减少碎片化。
• 版本升级门槛： 每次 Android 大版本升级（如 Android 13 → 14），设备必须重新通过对应版本的 CTS 认证。

1.2 Camera CTS 测试套件介绍

Camera CTS 是 CTS 中规模最大、复杂度最高的子系统之一。它覆盖了从 Camera API 1 到 Camera API 2（Camera2）的全部接口，包括预览、拍照、录像、参数控制、格式转换、多摄像头协同等场景。

Camera CTS 的测试分类

Camera CTS 的执行架构

Camera CTS 测试在 Android 设备上以 APK 形式运行，通过 CameraManager API 与 Camera Service 通信，最终下发到 HAL 层。其执行链路如下：

1. CTS 测试 APK 调用 Android Camera API（Camera1 或 Camera2）。
2. Camera Service（cameraserver 进程）接收请求，解析为 HAL 命令。
3. HAL 层（Camera HAL v3 或 v4）实现具体的硬件控制逻辑。
4. Kernel 驱动 与 Sensor、ISP 交互，返回图像数据。
5. 数据沿原路径返回，CTS 测试 APK 校验结果是否符合预期。

Camera CTS 的测试用例命名规范

理解测试用例的命名规则，有助于快速定位失败模块。Camera CTS 用例通常遵循以下格式：

android.hardware.camera2.cts.CameraTest#testCameraDeviceCreateRequest
├── 包名: android.hardware.camera2.cts
├── 测试类: CameraTest
└── 测试方法: testCameraDeviceCreateRequest

Camera CTS 的测试结果判定标准

Camera CTS 的判定逻辑非常严格，不仅要求功能正常，还要求行为完全符合 API 规范。常见的失败原因包括：

• 返回值错误： HAL 返回了 API 规范中未定义的值。
• 超时： 某个操作（如拍照、开启预览）超过规定时间未完成。
• 数据格式不符： 输出的图像格式、尺寸、颜色空间与请求不匹配。
• 状态机异常： 在错误的 Camera 状态下调用了不允许的操作。
• 特性缺失： 设备声称支持某个特性（如 HDR），但实际未正确实现。