4、CTS测试套件结构：CTS测试用例分类、Camera相关测试模块、测试计划与测试包

CTS（Compatibility Test Suite）是Android兼容性测试的核心工具集，其套件结构设计遵循模块化、分层化的原则。对于Camera HAL开发者而言，理解CTS的测试用例分类体系、Camera专用测试模块的组织方式以及测试计划与测试包的生成逻辑，是高效定位HAL层兼容性问题的前提。

4.1 CTS测试用例分类体系

CTS测试用例按照测试范围、执行方式和目标组件分为多个维度。下表列出了主要的分类维度及其在Camera HAL开发中的关注点：

4.2 Camera相关测试模块：android.hardware.camera2.*

Camera CTS测试模块以android.hardware.camera2为根包名，按功能域划分为多个子模块。每个子模块对应一个独立的测试APK，包含一组针对特定Camera特性的测试用例。

下表列出了Camera HAL开发中最常涉及的测试模块及其核心验证目标：

以下SVG图展示了Camera CTS测试模块的层级依赖关系：

4.3 测试计划（Test Plan）与测试包（Test Package）

CTS使用测试计划（Test Plan）来组织和管理测试用例的执行。一个测试计划是一个XML配置文件，定义了需要执行的测试模块列表、执行顺序、过滤规则以及设备要求。测试包（Test Package）则是测试计划的物理载体，通常以ZIP或JAR格式分发。

4.3.1 测试计划的结构

一个典型的CTS测试计划文件（如camera2.xml）包含以下核心元素：

<?xml version="1.0" encoding="utf-8"?>
<TestPlan version="1.0">
    <name>Camera2 Full Test Plan</name>
    <description>Complete Camera2 CTS test plan for Android 14</description>
    <modules>
        <module name="CtsCameraTestCases">
            <option name="include-filter" value="android.hardware.camera2.cts.*" />
            <option name="exclude-filter" value="android.hardware.camera2.cts.performance.*" />
        </module>
        <module name="CtsCameraPerformanceTestCases">
            <option name="include-filter" value="android.hardware.camera2.cts.performance.*" />
        </module>
    </modules>
    <requirements>
        <requirement name="device-feature" value="android.hardware.camera" />
        <requirement name="min-sdk" value="34" />
    </requirements>
</TestPlan>

4.3.2 测试包的生成与部署

CTS测试包通过build/tools/cts/build-cts-package.sh脚本生成。生成后的测试包包含以下目录结构：

4.3.3 测试计划的执行流程

以下SVG图展示了从测试计划加载到结果输出的完整执行流程：

4.3.4 自定义测试计划的最佳实践

在Camera HAL开发中，建议遵循以下步骤创建自定义测试计划：

1. 确定测试范围：根据当前HAL修改的模块，选择对应的测试模块。例如，修改了AE算法，应包含android.hardware.camera2.cts.parameters和android.hardware.camera2.cts.performance。
2. 设置过滤规则：使用include-filter和exclude-filter精确控制测试用例范围，避免执行无关测试。
3. 配置设备要求：确保requirements部分与目标设备匹配，特别是device-feature和min-sdk。
4. 验证测试计划：使用cts-tradefed run plan --plan <plan_name> --dry-run命令验证计划配置是否正确。