Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .
Запуск автоматизированных тестов (Android 11 или выше),Запуск автоматизированных тестов (Android 11 или выше)
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Существует два варианта запуска автоматизированных тестов CTS:
Trade Federation — это приложение и тестовый фреймворк, который позволяет запускать тесты из командной строки. По сути, фреймворк позволяет вам аннотировать тесты с помощью аннотации @Test , а приложение находит и запускает эти тесты.
OmniLab Android Test Station — это приложение, позволяющее запускать тесты в графическом интерфейсе.
На этой странице объясняется, как запускать автоматизированные тесты с помощью Trade Federation. Инструкции по запуску тестов с помощью OmniLab Android Test Harness см. в OmniLab Android Test Station .
Запустите все автоматизированные тесты CTS
Trade Federation содержит консоль CTS , интерфейс командной строки для запуска тестов. Чтобы запустить весь автоматизированный набор тестов CTS:
- Убедитесь, что вы выполнили инструкции в разделе Настройка автоматизированного тестирования CTS .
На тестовой рабочей станции запустите консоль CTS, выполнив скрипт cts-tradefed из папки, куда был распакован пакет CTS:
./android-cts/tools/cts-tradefed
Консоль CTS отображает курсор для ввода команд CTS ( cts-tradefed > ).
План тестирования cts содержит все автоматизированные тесты CTS. Выполните следующую команду для запуска плана тестирования cts :
run cts
Выполняются автоматизированные тесты CTS. Обратите внимание на следующее:
Android 13 и выше поддерживают многоустройственное тестирование. Эти тесты запускаются автоматически только при использовании шардинга. Для получения дополнительной информации о шардинге см. раздел Улучшение времени выполнения теста . Если вы хотите запустить эти тесты вручную, см. раздел Запуск многоустройственных тестов .
При каждом запуске CTS нажмите ctrl+c, чтобы остановить существующую консоль CTS, а затем перезапустите консоль CTS.
Невозможно запустить несколько версий CTS на одном хосте, поскольку каждая из них открывается с существующим сервером открытого кода местоположения (OLC).
Просмотреть результаты теста. Для получения дополнительной информации см. Интерпретация результатов CTS .
Если это ваш первый тестовый запуск, могут быть тесты, которые не пройдены из-за проблем, находящихся вне вашего контроля. Например, сетевое соединение может быть медленным или сигнал GPS может быть слабым. Повторно запустите (повторите) тесты, пока все тестовые модули не будут завершены, а количество неудачных тестов не станет одинаковым между двумя последними повторными сеансами:
run retry --retry session_number`
После того, как сбои тестов будут постоянными при повторных попытках, сосредоточьтесь на отладке оставшихся сбойных тестов. Для получения информации об устранении неполадок в результатах тестов см. Triage test failures и Troubleshoot CTS tests .
Запустить CTS для многоэкранных устройств
Если ваше устройство работает под управлением Android 11 или 12 и имеет несколько экранов, вам необходимо запустить план тестирования cts-foldable отдельно:
run cts-foldable
Пройденные или неудачные тестовые случаи для альтернативного режима экрана добавляются со значением из display_mode , например, testcase1[display_mode=0] .
Запуск многоустройственных тестов (Android 15 или ниже)
Выполните следующую команду для запуска плана тестирования cts-multidevice :
run cts-multidevice
Выполнение индивидуальных планов тестирования
Вместо того, чтобы запускать все тестовые планы одновременно, вы можете запустить индивидуальные тестовые планы. Эта опция полезна для экономии времени и сосредоточения на определенном наборе тестов. Чтобы запустить индивидуальный тестовый план:
Определите имя плана тестирования, который вы хотите запустить, выполнив команду list modules .
Запустите план тестирования:
run cts --plan test_module_or_plan_name
Улучшить время выполнения теста
Если вы хотите улучшить время выполнения теста, вы можете разбить тесты на несколько устройств. Для разбиения требуется, чтобы хост подключал не менее двух устройств, но для эффективности рекомендуется шесть или более устройств.
Для сегментации тестов на Android 11 или выше выполните:
run cts --shard-count number_of_shards
Кроме того, перед запуском тестов для проверки вы можете улучшить время выполнения теста, используя команду CTS run cts-dev . Эта команда пропускает предварительные условия, сбор информации об устройстве и все проверки состояния системы. Она также запускает тесты только на одном ABI.
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-30 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-07-30 UTC."],[],[],null,["# Run automated tests (Android 11 or higher)\n\nThere are two options for running CTS automated tests:\n\n- *Trade Federation* is an app and test framework that lets you\n run tests from the command line. Fundamentally, the framework\n lets you annotate tests using the `@Test` annotation and the app finds and runs\n those tests.\n\n- *OmniLab Android Test Station* is an app that lets you run tests\n in a GUI.\n\nThis page explains how to run automated tests using Trade Federation. For\ninstructions on running tests using OmniLab Android Test Harness, see\n[OmniLab Android Test Station](/docs/core/tests/development/android-test-station/ats-user-guide).\n\nRun all automated CTS tests\n---------------------------\n\nTrade Federation contains the *CTS console*, a command-line interface for\nrunning tests. To run the entire automated CTS test suite:\n\n1. Ensure you have followed the instructions in [Set up CTS automated testing](/docs/compatibility/cts/setup).\n2. On your test workstation, launch the CTS console by running the `cts-tradefed` script from the folder where the CTS package has been unzipped:\n\n ./android-cts/tools/cts-tradefed\n\n The CTS console displays a cursor for you to type CTS commands\n (`cts-tradefed \u003e`).\n3. The `cts` test plan contains all of the automated CTS tests. Execute the\n following command to run the `cts` test plan:\n\n run cts\n\n The automated CTS tests execute. Note the following:\n - Android 13 and higher support multidevice testing. These tests run\n automatically only when sharding is used. For further information on sharding,\n see [Improve test execution time](#improve). If you want to run these tests\n manually, see [Run multidevice tests](#multi-device-testing).\n\n - Whenever running CTS, press **ctrl+c** to stop the existing CTS console\n and then rerun the CTS console.\n\n - You can't run multiple CTS versions on single host because each opens\n with an existing open location code (OLC) server.\n\n4. View test results. For more information, see [Interpret CTS results](/docs/compatibility/cts/interpret).\n\n5. If this is your first test run, there might be tests that fail due to issues beyond your control. For example, a network connection might be slow or a GPS signal might be weak. Rerun (retry) the tests until all test modules are completed and the test failure numbers are the same between the last two retry sessions:\n\n run retry --retry \u003cvar translate=\"no\"\u003esession_number\u003c/var\u003e`\n\n | **Note:** For implementation details for CTS retry, see [Use suite retry](/docs/core/tests/tradefed/testing/through-suite/suite-retry).\n | **Note:** For instructions on how to run a retry session on Android 10 or lower, see [Run CTS automated tests (AOSP 10 or lower)](/docs/compatibility/cts/run-older).\n6. After tests failures are consistent across retries, focus on debugging\n the remaining failed tests. For information on troubleshooting test\n results, see\n [Triage test failures](/docs/compatibility/cts/interpret#triaging-test-failures)\n and\n [Troubleshoot CTS tests](/docs/compatibility/cts/troubleshooting).\n\n| **Note:** For a list of all CTS console commands, see [CTS v2 command console](/compatibility/cts/command-console-v2).\n\nRun CTS for multiscreen devices\n-------------------------------\n\nIf your device is running Android 11 or 12, and your device has multiple\nscreens, you must run the `cts-foldable` test plan separately: \n\n run cts-foldable\n\nPassed or failed test cases for alternate screen mode are appended with the\nvalue from `display_mode`, for example, `testcase1[display_mode=0]`.\n| **Note:** For instructions on how to run the `cts-foldable` test plan for Android 10 or lower, see [Run CTS automated tests (Android 10 or lower)](/docs/compatibility/cts/run-older).\n\nRun multidevice tests (Android 15 or lower)\n-------------------------------------------\n\nExecute the following command to run the `cts-multidevice` test plan: \n\n run cts-multidevice\n\nRun individual test plans\n-------------------------\n\nInstead of running all test plans at once, you can run individual test plans.\nThis option is useful to save time and to focus on a specific set of tests.\nTo run an individual test plan:\n\n1. Identify the name of the test plan you want to run by executing the `list modules` command.\n\n | **Note:** For instructions on how to identify the module on Android 10 or lower, see [Run CTS automated tests (Android 10 or lower)](/docs/compatibility/cts/run-older).\n2. Run the test plan:\n\n run cts --plan \u003cvar translate=\"no\"\u003etest_module_or_plan_name\u003c/var\u003e\n\nImprove test execution time\n---------------------------\n\nIf you want to improve test execution time, you can shard tests across multiple\ndevices. Sharding requires the host to connect at least two devices, but six or\nmore devices are recommended for efficiency.\n\nTo shard tests on Android 11 or higher, run: \n\n run cts --shard-count \u003cvar translate=\"no\"\u003enumber_of_shards\u003c/var\u003e\n\nAdditionally, before running your tests for validation you can improve test\nexecution time by using the CTS `run cts-dev` command. This command skips\npreconditions, device-information collection, and all system status checkers.\nIt also runs the tests on only a single ABI."]]
