Тест из командной строки

В этом документе описывается, как запускать тесты непосредственно из командной строки. Предполагается, что вы уже знаете, как создавать приложения для Android и писать для них тесты. Дополнительную информацию о создании тестов для вашего приложения см. в разделе «Тестирование приложений на Android» .

При сборке приложения с использованием системы сборки Gradle плагин Android Gradle позволяет запускать тесты из проекта Gradle через командную строку. Для более точного контроля можно выбрать запуск тестов через оболочку Android Debug Bridge (adb) . Это может быть полезно при запуске тестов в среде непрерывной интеграции .

Чтобы узнать, как запускать автоматизированные инструментальные тесты из командной строки с использованием виртуальных устройств, которыми управляет Gradle, см. раздел «Масштабирование тестов с помощью управляемых устройств Gradle» .

Запуск тестов с помощью Gradle

Плагин Android Gradle позволяет запускать тесты из вашего проекта Gradle с помощью командной строки.

В таблице ниже приведено краткое описание того, как запускать тесты с помощью Gradle:

Таблица 1. Различные способы запуска тестов с помощью Gradle.

./gradlew test

./gradlew connectedAndroidTest

Gradle поддерживает сокращения в именах задач . Например, вы можете запустить задачу connectedAndroidTest , введя следующую команду:

./gradlew cAT

Вы также можете выбрать запуск задач Gradle check и connectedCheck . Эти задачи запускают ваши локальные или инструментальные тесты соответственно, но включают в себя другие проверки, добавленные другими плагинами Gradle.

Запуск тестов для модуля

Задачи test и connectedAndroidTest запускают тесты для каждого модуля в вашем проекте. Вы можете запустить тесты для конкретного модуля, добавив перед задачей test или connectedAndroidTest имя модуля и двоеточие (:). Например, следующая команда запускает инструментальные тесты только для модуля mylibrary :

./gradlew mylibrary:connectedAndroidTest

Запустите тесты на варианте сборки.

Задачи test и connectedAndroidTest запускают тесты для каждого варианта сборки в вашем проекте. Вы можете выбрать конкретный вариант сборки, используя следующий синтаксис:

• Для локальных модульных тестов:

  ./gradlew testVariantNameUnitTest

• Для инструментальных испытаний:

  ./gradlew connectedVariantNameAndroidTest

Запустите определенные тестовые методы или классы.

При запуске локальных модульных тестов Gradle позволяет выбирать конкретные тесты с помощью флага --tests . Например, следующая команда запускает только тесты sampleTestMethod для указанного варианта сборки. Чтобы узнать больше об использовании флага --tests , ознакомьтесь с документацией Gradle по фильтрации тестов .

./gradlew testVariantNameUnitTest --tests '*.sampleTestMethod'

Запуск тестов с помощью adb

При запуске тестов из командной строки с помощью Android Debug Bridge (adb) у вас больше возможностей для выбора запускаемых тестов, чем при любом другом методе. Вы можете выбирать отдельные методы тестирования, фильтровать тесты по пользовательской аннотации или указывать параметры тестирования. Поскольку запуск тестов полностью контролируется из командной строки, вы можете настраивать тестирование с помощью скриптов оболочки различными способами.

Чтобы запустить тест из командной строки, выполните adb shell чтобы запустить командную оболочку на вашем устройстве или эмуляторе. Внутри этой оболочки вы можете взаимодействовать с менеджером активности, используя команду am , и использовать его подкоманду instrument для запуска тестов.

В качестве быстрого способа можно запустить оболочку adb, вызвать команду am instrument и указать флаги командной строки в одной строке ввода. Оболочка откроется на устройстве или эмуляторе, выполнит ваши тесты, выведет результат, а затем вернется к командной строке на вашем компьютере.

Для проведения теста с помощью am instrument :

1. Создайте или пересоберите основное приложение и тестовый пакет.
2. Установите тестовый пакет и основные файлы пакета Android-приложения (файлы APK) на ваше текущее устройство Android или эмулятор.

3. В командной строке введите:

   adb shell am instrument -w <test_package_name>/<runner_class>

   Где <test_package_name> — это имя пакета Android вашего тестового приложения, а <runner_class> — имя класса запуска тестов Android, который вы используете. Имя пакета Android — это значение атрибута package элемента manifest в файле манифеста вашего тестового пакета ( AndroidManifest.xml ).

   Класс для запуска тестов в Android обычно называется AndroidJUnitRunner :

   adb shell am instrument -w com.android.example/androidx.test.runner.AndroidJUnitRunner

Результаты вашего теста отображаются в STDOUT ).

флажки приборов AM

Чтобы получить список всех флагов, используемых с командой am instrument , выполните adb shell am help . Некоторые важные флаги описаны в следующей таблице:

Таблица 2. Важные флаги am instrument

варианты инструментов AM

Инструмент am instrument передает параметры тестирования в AndroidJUnitRunner или InstrumentationTestRunner в виде пар ключ-значение, используя флаг -e , со следующим синтаксисом:

-e <key> <value>

Некоторые ключи принимают несколько значений. Вы указываете несколько значений в списке, разделенном запятыми. Например, этот вызов AndroidJUnitRunner предоставляет несколько значений для ключа package :

adb shell am instrument -w -e package com.android.test.package1,com.android.test.package2 \
> com.android.test/androidx.test.runner.AndroidJUnitRunner

В таблице ниже перечислены пары ключ-значение, которые можно использовать в вашем средстве запуска тестов:

Таблица 3. Пары ключ-значение -e для использования с вашим средством запуска тестов.

При использовании флага -e следует учитывать следующее:

• am instrument вызывает onCreate(Bundle) с Bundle , содержащим пары ключ-значение.
• Ключ package имеет приоритет над ключом class . Если вы указываете пакет, а затем отдельно указываете класс внутри этого пакета, Android запускает все тесты в пакете и игнорирует ключ класса.
• Клавиша func и клавиша unit являются взаимоисключающими.

Примеры использования

В следующих разделах приведены примеры использования am instrument для запуска тестов. Они основаны на следующей структуре:

• Тестовый пакет имеет имя пакета Android com.android.demo.app.tests .
• Два класса инструментальных испытаний:
  • TestClass1 , содержащий тестовый метод testMethod1 .
  • TestClass2 содержит тестовые методы testMethod2 и testMethod3 .
• В качестве средства запуска тестов используется AndroidJUnitRunner .

Запустите весь пакет тестов.

Чтобы запустить все тестовые классы из тестового пакета, введите:

adb shell am instrument -w com.android.demo.app.tests/androidx.test.runner.AndroidJUnitRunner

Запустите все тесты в классе тестового примера.

Чтобы запустить все тесты в классе TestClass1 , введите:

adb shell am instrument -w  \
> -e class com.android.demo.app.tests.TestClass1 \
> com.android.demo.app.tests/androidx.test.runner.AndroidJUnitRunner

Выберите подмножество тестов

Чтобы запустить все тесты в классе TestClass1 и метод testMethod3 в TestClass2 , введите:

adb shell am instrument -w \
> -e class com.android.demo.app.tests.TestClass1,com.android.demo.app.tests.TestClass2#testMethod3 \
> com.android.demo.app.tests/androidx.test.runner.AndroidJUnitRunner

Дополнительные примеры использования можно найти в справочнике API AndroidJUnitRunner .

Просмотреть унифицированные отчеты о тестировании

Плагин Android Gradle предоставляет унифицированные задачи для создания отчетов о тестировании, которые генерируют HTML-панели мониторинга, объединяющие результаты модульных и инструментальных тестов.

Предварительные требования

• Android Gradle Plugin 9.2.0-alpha07 или выше.

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