3. CTS与VTS概述
在Android生态中，设备能否搭载Google移动服务（GMS）并进入全球市场，取决于它是否通过了两类核心测试：CTS（Compatibility Test Suite，兼容性测试套件）与VTS（Vendor Test Suite，供应商测试套件）。二者共同构成Android兼容性认证的技术底座，但它们的测试对象、测试层次与失败后果截然不同。理解这两套测试的定位，是Camera模块验证工程的第一步。
一、CTS与VTS的定义
CTS是一套由Google维护的、面向应用层与框架层API行为的自动化测试集合。它通过运行大量测试用例，验证设备在Android框架API、权限模型、多媒体、图形、传感器、相机等公开接口上的行为是否符合Android兼容性定义文档（CDD）。CTS的核心问题是：“这台设备能否正确运行面向Android标准API开发的应用？”
VTS则面向硬件抽象层（HAL）与内核层，重点验证供应商实现的HAL接口、内核接口、以及Treble架构下的Vendor与System分区交互是否符合规范。VTS的核心问题是：“这台设备的底层实现能否与Android系统框架稳定对接，并支持后续系统升级？”
二、CTS与VTS的核心区别
下表从测试对象、运行环境、失败影响等维度对比两者，便于在项目中快速判断问题归属。
| 对比维度 | CTS | VTS |
|---|---|---|
| 测试对象 | 应用框架API、系统应用、权限、媒体、相机API | HAL接口、内核、Treble分区接口、Vendor实现 |
| 测试层次 | Framework / Application | HAL / Kernel / Vendor |
| 运行环境 | 设备端，通过adb驱动 | 设备端 + 主机端，常配合shell与Python |
| 主要工具 | cts-tradefed | vts-tradefed |
| 失败后果 | 无法获得GMS授权，不能预装Google应用 | 无法通过Treble兼容性，影响系统升级与认证 |
| Camera关注点 | Camera2 API、CameraX、图像格式、元数据 | Camera HAL3接口、Provider、流配置、Buffer管理 |
三、测试范围与Camera模块的映射
在Camera验证中，CTS与VTS的测试范围可以这样理解：CTS从应用视角调用CameraManager、CameraDevice、CaptureRequest等API，检查返回的图像、元数据、状态回调是否符合CDD要求；VTS则从系统视角直接调用ICameraProvider、ICameraDevice、ICameraDeviceSession等HIDL/AIDL接口，检查HAL实现是否满足接口契约。
下面这张图展示了从应用到内核的垂直分层，以及CTS与VTS各自覆盖的区间。可以看到，两者在Camera栈中形成“上下夹击”的验证结构：CTS守住应用可见行为，VTS守住硬件接口契约。
四、在Android兼容性认证中的作用
Android兼容性认证并非单一测试，而是一条由CDD、CTS、VTS、GTS等共同构成的证据链。其中：
- CTS是GMS授权的硬门槛。设备必须通过CTS才能申请GMS授权，进而预装Google Play、Gmail等应用。Camera CTS失败会直接阻断认证流程。
- VTS是Treble兼容性与系统升级的保障。通过VTS意味着Vendor实现与System框架之间的接口稳定，设备可以更平滑地升级到新Android版本。
- 两者共同支撑CDD符合性。CDD定义“必须做什么”，CTS与VTS分别从上层和下层验证“是否真的做到了”。
五、典型场景与常见误区
假设某项目Camera预览正常，但CTS中Camera2Test用例失败，同时VTS中CameraHidlTest通过。这通常说明HAL接口实现没问题，问题出在框架层或应用可见行为上，例如元数据字段缺失、帧率声明不符、权限回调异常。反之，若VTS失败而CTS通过，则问题更可能位于HAL实现、内核驱动或Vendor分区配置。
# 运行Camera相关CTS模块（示例）
run cts -m CtsCameraTestCases -t android.hardware.camera2.cts.CameraManagerTest
# 运行Camera相关VTS模块（示例）
run vts -m VtsHalCameraProviderV2_4TargetTest
# 查看失败详情
run cts --retry 0 --shard-count 1
总结来说，CTS与VTS是Android兼容性认证中互补的两套验证体系：CTS回答“设备像不像一台标准Android设备”，VTS回答“设备的底层实现是否守规矩”。在Camera验证工程中，只有同时理解两者的边界与交集，才能快速定位问题、组织测试并推动认证通过。