Camera CTS测试框架：测试模块分类、执行流程与结果解析

Camera CTS（Compatibility Test Suite）是Android兼容性测试的核心组成部分，专门用于验证设备Camera HAL（硬件抽象层）及框架实现是否符合Android兼容性定义文档（CDD）的要求。本章将深入剖析Camera CTS的测试模块分类、用例执行流程以及测试结果报告的解析方法，帮助开发者快速定位HAL适配问题。

2.1 Camera CTS测试模块分类

Camera CTS测试用例按照测试范围和功能特性划分为多个模块，每个模块对应不同的测试维度。下表列出了主要的测试模块及其核心验证目标：

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

2.2 测试用例执行流程

Camera CTS测试用例的执行遵循标准化的生命周期，从测试环境准备到最终结果输出，每个阶段都有明确的职责。以下是完整的执行流程：

1. 环境准备阶段：确保设备已解锁、adb连接正常、已安装测试APK，并关闭不必要的后台服务。
2. 测试调度阶段：CTS测试框架根据测试计划（test plan）加载对应的测试模块和用例列表。
3. 用例执行阶段：每个测试用例按顺序执行，包括前置条件检查、测试动作、结果断言和清理操作。
4. 结果收集阶段：测试框架收集每个用例的通过/失败状态、日志和截图等附件。
5. 报告生成阶段：汇总所有测试结果，生成XML格式的测试报告和HTML格式的可视化报告。

下图展示了Camera CTS测试用例的详细执行流程：

# 执行所有Camera测试模块
run cts -m CameraTest --skip-preconditions

# 执行单个测试用例
run cts -m CameraTest -t android.hardware.camera2.cts.CameraTest#testPreview

# 生成详细日志
run cts -m CameraTest --log-level VERBOSE --log-output /data/local/tmp/cts_logs

2.3 测试结果报告解析

Camera CTS执行完成后会生成两种格式的报告：XML格式的机器可读报告和HTML格式的可视化报告。正确解析报告是定位HAL适配问题的第一步。

2.3.1 报告文件结构

测试报告通常位于 android-cts/reports/ 目录下，主要包含以下文件：

2.3.2 XML报告关键字段解析

以下是一个典型的Camera CTS测试结果XML片段及其关键字段说明：

<?xml version="1.0" encoding="UTF-8"?>
<TestResult>
    <Summary>
        <Passed>142</Passed>          <!-- 通过用例数 -->
        <Failed>3</Failed>            <!-- 失败用例数 -->
        <ModuleDone>8</ModuleDone>    <!-- 完成的模块数 -->
        <ModulesTotal>8</ModulesTotal> <!-- 总模块数 -->
    </Summary>
    <Module name="CameraTest">
        <TestCase name="testPreview">
            <Test status="pass" />    <!-- 通过 -->
        </TestCase>
        <TestCase name="testCapture">
            <Test status="fail">      <!-- 失败 -->
                <StackTrace>
java.lang.AssertionError: 
Expected: preview frame received within 3000ms
Actual: timeout occurred
                </StackTrace>
            </Test>
        </TestCase>
    </Module>
</TestResult>

2.3.3 报告解析实战技巧

在HAL适配过程中，高效解析测试报告可以大幅缩短问题定位时间。以下是一些实用技巧：

• 优先查看Failed模块：在index.html中，失败模块会以红色高亮显示，点击即可查看具体失败的测试用例。
• 分析StackTrace：每个失败用例都包含详细的堆栈信息，重点关注 AssertionError 或 RuntimeException 的描述。
• 对比日志时间戳：在logs目录中，对比HAL层日志和测试框架日志的时间戳，可以判断延迟发生在哪个环节。
• 使用cts-tradefed过滤：通过 --retry 参数重新执行失败用例，验证修复效果。

下图展示了从测试报告到HAL问题定位的完整分析流程：

| 模块 | 用例名 | 失败原因 | 修复状态 | 备注 |
|------|--------|----------|----------|------|
| CameraTest | testPreview | 超时3000ms | 待修复 | HAL流启动延迟 |