一、CTS 测试概述
CTS 全称兼容性测试套件，是谷歌官方自动化兼容性测试工具，用于校验安卓设备符合安卓兼容性规范，是设备过 GMS 认证、预装谷歌应用必备测试项，包含自动化 CTS 测试 + 手动 CTS-V 测试。
二、测试手机预置条件（必配）
- 网络配置：设备连接可翻墙 WiFi，部分测试用例需访问谷歌官网
- SIM 卡配置：插入正常可用有话费 SIM 卡（优先联通卡），进入设置 - SIM 卡管理标注对应手机号
- SD 卡配置：插入空白高速 SD 卡，支持 SDHC/SDXC、Class10 及以上规格，建议容量 8G 及以上
- 屏幕锁定 ：设置 - 安全 - 屏幕锁定方式，改为无
- 开发者选项
-
- 开启充电时保持亮屏 / 不锁定屏幕
- 开启USB 调试
- 关闭通过 USB 验证应用
- 系统时间：关闭 24 小时制显示
- 权限定位：开启设备位置信息开关
- 浏览器初始化：打开 Chrome 浏览器，完成初始化，选择不登录、拒绝推荐
- 桌面状态：测试全程保持停留在手机主桌面，运行中禁止触碰屏幕、实体按键
- 系统语言 ：设备系统语言统一设置为English（United States）
三、测试服务器环境配置
- JDK 环境 ：适配 Android11 版本，部署OpenJDK11
- aapt 工具部署
-
- 从 Android SDK 中提取 aapt 工具
- 放置路径：
/user/bin - 赋予最高权限：
chmod 777 /user/bin/aapt
- 测试包获取途径
-
- 官方原版 CTS 包：https://source.android.com/compatibility/cts/downloads
- 机构内测版、PAB 版本：对接第三方测试机构获取
- Media 媒体测试包配置
-
- 最新版本：
android-cts-media-1.5 - 解压路径：
/tmp/android-cts-media - 完整路径：
/tmp/android-cts-media/android-cts-media-1.5 - 注意：tmp 为系统临时目录，服务器重启后需重新解压拷贝媒体资源
- 最新版本：
四、CTS 标准测试操作方法
-
打开服务器终端 Terminal，进入 CTS 工具目录
cd android-cts/tools
-
启动 CTS 测试控制台
./cts-tradefed
异常判断：执行后终端直接闪退，代表服务器 Java 环境版本配置错误
-
基础全局测试命令
执行全量完整CTS测试
run cts
查看全部命令帮助
run cts --help-all
五、CTS 高频实用测试命令
-
单独重跑失败用例
run retry --retry sessionID
查看会话 ID：输入lr查询
-
指定模块整体测试
run cts -m 模块名
-
精准测试单个测试类 / 单用例
run cts -m 模块名 -t 测试类名
-
多设备并行批量测试
填写设备数量
run cts --shard-count 设备数
-
指定序列号单独设备测试
run cts -s 设备SN1 -s 设备SN2
-
跳过设备预置条件检测无需联网、GPS 等前置条件时使用，跳过强制校验
run cts 原有命令 --skip-preconditions
-
扩大日志存储上限，保留完整日志解决大版本测试日志被覆盖问题
run cts 原有命令 --max-tmp-logcat-file 2000000000 --max-log-size 2000000000
-
失败用例自动截屏
run cts 原有命令 --screenshot-on-failure
-
偶现问题循环压测
run cts -m 模块名 --loop -min-loop-time 3000
-
快速查看测试结果
lr
六、测试结果查看与日志路径
- 测试报告路径
android-cts/results文件夹以测试时间命名，内置test_result.xml，右键浏览器打开可查看全量用例 Pass/Fail 详情，同时自动生成压缩包报告。 - 日志文件路径
android-cts/logs
- Host log：服务器终端执行打印日志
- Device log：设备端系统日志、主进程运行日志
七、Package 与测试类定位方法
测试用例失败后，直接在测试报告内查询该失败项对应的所属 Package 包名 与Class 测试类名，精准定位问题代码位置。
八、CTS Partner Android Build (PAB) 版本说明
- 释义：谷歌 CTS 日常迭代内测编译版本，正式商用 CTS 版本更新缓慢，大量兼容性问题会优先在 PAB 版本修复
- 获取方式：无公开下载渠道，仅可向官方合作测试机构申领
- 问题豁免规则正式商用 CTS 版本测试失败，PAB 内测版本测试通过 ，该类 CTS/VTS/GSI 测试问题无需提交豁免申请，直接将 PAB 版本通过报告上传至APFE 安卓合作伙伴后台即可完成认证。
九、源码查询官方地址
CTS 原生测试用例源码查阅：https://android.googlesource.com/platform/cts/