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

Используйте консоль CTS v2.

Для Android 7.0 или более поздней версии используйте CTS v2.

Выберите планы

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

  • cts — запускает CTS из существующей установки CTS.
  • cts-camera — запускает CTS-камеру из уже существующей установки CTS.
  • cts-java — запускает основные тесты Java из уже существующей установки CTS.
  • 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 или выше. Повторите все тесты, которые не были выполнены или не были выполнены в предыдущих сеансах. Например, 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 Дамп журналов обмена для всех запущенных вызовов.
Добавлять Описание
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 действителен.