Командная консоль CTS v2

Использование консоли CTS v2

Для Android 7.0 или выше используйте CTS v2.

Выбор планов

Доступные планы тестирования включают следующее:

  • cts — запускает CTS из уже существующей установки CTS.
  • cts-camera — запускает CTS-камеру из уже существующей установки CTS.
  • cts-java — запускает базовые тесты Java из уже существующей установки CTS.
  • cts-pdk — запускает тесты, полезные при проверке сборки PDK fusion.
  • все — Общий конфиг для комплектов совместимости.

Другие доступные конфигурации включают следующее:

  • basic-reporters — Конфигурация с базовыми репортерами CTS.
  • collect-tests-only — запускает CTS из уже существующей установки CTS.
  • common-compatibility-config — общая конфигурация для комплектов совместимости.
  • cts-filtered-sample — общая конфигурация для комплектов совместимости.
  • cts-known-failures — Конфигурация с известными отказами CTS.
  • cts-preconditions — конфиги преусловий CTS.
  • host — Запускает один хост-тест на существующем устройстве.
  • Instrument — запускает один инструментальный тест 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 и выше. Повторите все тесты, которые не прошли или не были выполнены из предыдущих сеансов. Например, run retry --retry -s или run retry --retry --shard-count с сегментированием TF.

run cts --retry не разрешен для Android 9 и выше.

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_CARD , UICC_SIM_CARD и SECURE_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 , чтобы получить идентификатор сеанса.
--retry-type NOT_EXECUTED Повторяйте только те тесты, которые не выполнялись в предыдущих сеансах. Используйте list results , чтобы получить идентификатор сеанса.
--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 plans или list 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 действителен.