CTS v2 命令控制台

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

使用 CTS v2 控制台

对于 Android 7.0 或更高版本,请使用 CTS v2。

选择计划

可用的测试计划包括以下内容:

  • cts — 从预先存在的 CTS 安装运行 CTS。
  • cts-camera — 从预先存在的 CTS 安装运行 CTS-camera。
  • cts-java — 从预先存在的 CTS 安装运行核心 Java 测试。
  • cts-pdk — 运行对验证 PDK 融合构建有用的测试。
  • 一切——兼容性套件的通用配置。

其他可用配置包括:

  • basic-reporters — 基本 CTS 报告器的配置。
  • collect-tests-only - 从预先存在的 CTS 安装运行 CTS。
  • common-compatibility-config — 兼容性套件的通用配置。
  • cts-filtered-sample — 兼容性套件的通用配置。
  • cts-known-failures — 具有 CTS 已知故障的配置。
  • cts-preconditions — CTS 前置条件配置。
  • 主机— 在现有设备上运行单个基于主机的测试。
  • 仪器— 在现有设备上运行单个 Android 仪器测试。
  • native-benchmark — 在现有设备上运行本机压力测试。
  • native-stress — 在现有设备上运行本机压力测试。
  • 充电- 等待几乎放电的设备并保持它们充电的假测试。
  • testdef — 在现有设备上运行 test_def.xml 文件中包含的测试。
  • util/wifi — 用于在设备上配置 Wi-Fi 的实用程序配置。
  • util/wipe — 擦除设备上的用户数据。

所有这些计划和配置都可以使用run cts命令执行。

CTS v2 控制台命令参考

此表总结了各种用途的 CTS v2 控制台命令。

主持人描述
help显示最常用命令的摘要
help all显示可用命令的完整列表
version显示版本。
exit优雅地退出 CTS 控制台。当所有当前正在运行的测试完成时,控制台关闭。
extdir

压缩的下载文件被解压缩到extdir 。如果您想摆脱膨胀的输出,请使用-q选项:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip -d extdir

如果要解压到当前目录,不要使用-d选项,只需运行:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip

跑步描述
run cts

在 Android 10 中,同时运行默认的 CTS 计划和 CTS-Instant(即完整的 CTS 调用)。对于 Android 9 或更低版本,仅运行默认 CTS 计划。使用此综合选项(包括先决条件)进行设备验证。有关包含内容,请参见cts.xml

CTS 控制台可以在测试进行时接受其他命令。

如果未连接任何设备,CTS 桌面计算机(或主机)将在开始测试之前等待设备连接。如果连接了多个设备,CTS 主机将自动选择一个设备。

run cts-instant

对于 Android 9,运行默认的 CTS-Instant 计划。

run cts --module-parameter INSTANT_APP

在 Android 10 中,运行默认的 CTS-Instant 计划。

run cts --module-parameter INSTANT_APP --module/-m test_module_name

在 Android 10 中,运行指定的 CTS-Instant 测试模块。

run retry

仅适用于 Android 9 或更高版本。重试之前会话中所有失败或未执行的测试。例如,使用 TF 分片run retry --retry -srun retry --retry --shard-count

Android 9 或更高版本不允许run cts --retry

run cts-sim

适用于 Android 11 或更高版本。在带有 SIM 卡的设备上运行测试子集。

--device-token

适用于 Android 8.1 或更低版本。指定给定设备具有给定令牌。例如, --device-token 1a2b3c4d:sim-card

--enable-token-sharding

仅适用于 Android 10 或更高版本。自动匹配需要相应 SIM 类型的测试。无需提供设备序列号即可执行 SIM 相关的测试用例。支持的 SIM 卡: SIM_CARDUICC_SIM_CARDSECURE_ELEMENT_SIM_CARD

run cts-dev

运行默认的 CTS 计划(即完整的 CTS 调用)但跳过前置条件以节省运行时间以进行新测试的迭代开发。这会绕过设备配置的验证和设置,例如推送媒体文件或检查 Wi-Fi 连接,就像使用--skip-preconditions选项时所做的那样。此命令还跳过设备信息收集和所有系统状态检查器。它还仅在单个 ABI 上运行测试。对于设备验证,请避免此优化并包括所有先决条件和检查。有关排除项,请参见cts-dev.xml

CTS 控制台可以在测试进行时接受其他命令。

如果未连接任何设备,CTS 桌面计算机(或主机)将在开始测试之前等待设备连接。如果连接了多个设备,CTS 主机将自动选择一个设备。

--subplan subplan_name运行指定的子计划。
--module/-m test_module_name --test/-t test_name运行指定的模块并测试。例如, run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes运行特定的包、类或测试。
--retry重试之前会话中失败或未执行的所有测试。使用list results获取会话 ID。
--retry-type NOT_EXECUTED仅重试以前会话中未执行的测试。使用list results获取会话 ID。
--shards number_of_shards适用于 Android 8.1 或更低版本。将 CTS 运行分片为给定数量的独立块,以在多个设备上并行运行。
--shard-count number_of_shards对于安卓 9 。将 CTS 运行分片为给定数量的独立块,以在多个设备上并行运行。
--serial/-s deviceID在特定设备上运行 CTS。
--include-filter "test_module_name test_name"使用指定的模块运行,或测试包、类和案例。例如, run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking"包含指定的模块。

运行重试时不支持此命令选项。

--exclude-filter "test_module_name test_name"从运行中排除指定的模块或测试包、类和案例。例如, run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking"排除指定模块。
--log-level-display/-l log_level以显示到STDOUT的最小指定日志级别运行。有效值:[ VERBOSE , DEBUG , INFO , WARN , ERROR , ASSERT ]。
--abi abi_name强制测试在给定的 ABI、32 或 64 上运行。默认情况下,CTS 为设备支持的每个 ABI 运行一次测试。
--logcat-on-failure ,
--bugreport-on-failure ,
--screenshoot-on-failure
提供对故障的更多可见性,并有助于诊断。
--device-token指定给定设备具有给定令牌,例如--device-token 1a2b3c4d:sim-card
--skip-device-info跳过有关设备的信息收集。
--skip-preconditions跳过先决条件以节省新测试的迭代开发的运行时间。这绕过了设备配置的验证和设置,例如推送媒体文件或检查 Wi-Fi 连接。
列表描述
list modules列出存储库中所有可用的测试模块。
list planslist configs列出存储库中所有可用的测试计划(配置)。
list subplans列出存储库中所有可用的子计划。
list invocations列出当前在设备上执行的“运行”命令。
list commands列出当前队列中等待分配给设备的所有“运行”命令。
list results列出当前存储在存储库中的 CTS 结果。
list devices列出当前连接的设备及其状态。

“可用”设备正在运行,空闲设备可用于运行测试。

“不可用”设备是通过 adb 可见的设备,但不响应 adb 命令并且不会分配用于测试。

“分配的”设备是当前运行测试的设备。

倾倒描述
dump logs转储所有正在运行的调用的 tradefed 日志。
添加描述
add subplan --name/-n subplan_name
--result-type
[pass | fail | timeout | notExecuted]
[--session session_id ]
创建从前一届会议派生的子计划;此选项生成可用于运行测试子集的子计划。

唯一需要的选项是--session 。其他是可选的,但如果包含,则必须后跟一个值。 --result-type选项是可重复的;例如add subplan --session 0 --result-type passed --result-type failed是有效的。