Testowanie z poziomu wiersza poleceń

Z tego dokumentu dowiesz się, jak uruchamiać testy bezpośrednio z wiersza poleceń. W tym dokumencie zakładamy, że wiesz już, jak tworzyć aplikacje na Androida i pisać do nich testy. Więcej informacji o tworzeniu testów aplikacji znajdziesz w artykule Testowanie aplikacji na Androida.

Gdy kompilujesz aplikację za pomocą systemu kompilacji Gradle, wtyczka Androida do obsługi Gradle umożliwia uruchamianie testów z poziomu projektu Gradle za pomocą wiersza poleceń. Aby mieć większą kontrolę, możesz przeprowadzać testy za pomocą powłoki Android Debug Bridge (adb). Może to być przydatne podczas przeprowadzania testów w środowisku ciągłej integracji.

Aby dowiedzieć się, jak uruchamiać zautomatyzowane testy instrumentacyjne z wiersza poleceń za pomocą urządzeń wirtualnych zarządzanych przez Gradle, przeczytaj artykuł Skalowanie testów za pomocą urządzeń zarządzanych przez Gradle.

Uruchamianie testów za pomocą Gradle

Wtyczka Androida do obsługi Gradle umożliwia uruchamianie testów z poziomu projektu Gradle za pomocą wiersza poleceń.

W tabeli poniżej znajdziesz podsumowanie sposobu przeprowadzania testów za pomocą Gradle:

Tabela 1. Różne sposoby przeprowadzania testów za pomocą Gradle

./gradlew test

./gradlew connectedAndroidTest

Gradle obsługuje skróty nazw zadań. Możesz na przykład zainicjować zadanie connectedAndroidTest, wpisując to polecenie:

./gradlew cAT

Możesz też uruchomić zadania Gradle check i connectedCheck. Te zadania uruchamiają odpowiednio testy lokalne lub testy z instrumentacją, ale obejmują też inne testy dodane przez inne wtyczki Gradle.

Uruchamianie testów w module

Zadania test i connectedAndroidTest przeprowadzają testy każdego modułu w projekcie. Testy możesz uruchamiać w określonym module, dodając do zadania test lub connectedAndroidTest nazwę modułu i dwukropek (:). Na przykład to polecenie uruchamia testy instrumentowane tylko w module mylibrary:

./gradlew mylibrary:connectedAndroidTest

Uruchamianie testów w wariancie kompilacji

Zadania test i connectedAndroidTest przeprowadzają testy na każdym wariancie kompilacji w projekcie. Możesz kierować reklamy na konkretną wersję kompilacji, używając tej składni:

• W przypadku lokalnych testów jednostkowych:

  ./gradlew testVariantNameUnitTest

• W przypadku testów z użyciem instrumentacji:

  ./gradlew connectedVariantNameAndroidTest

Uruchamianie konkretnych metod lub klas testowych

Podczas przeprowadzania lokalnych testów jednostkowych Gradle umożliwia kierowanie na konkretne testy za pomocą flagi --tests. Na przykład to polecenie uruchamia tylko testy sampleTestMethod dla określonego wariantu kompilacji. Więcej informacji o używaniu flagi --tests znajdziesz w dokumentacji Gradle na temat filtrowania testów.

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

Przeprowadzanie testów za pomocą adb

Gdy uruchamiasz testy z wiersza poleceń za pomocą Android Debug Bridge (adb), masz więcej opcji wyboru testów do uruchomienia niż w przypadku innych metod. Możesz wybrać poszczególne metody testowania, filtrować testy według niestandardowej adnotacji lub określić opcje testowania. Ponieważ przebieg testu jest w całości kontrolowany z wiersza poleceń, możesz dostosowywać testowanie za pomocą skryptów powłoki na różne sposoby.

Aby uruchomić test z wiersza poleceń, wpisz adb shell, aby uruchomić powłokę wiersza poleceń na urządzeniu lub emulatorze. W tej powłoce możesz wchodzić w interakcje z menedżerem aktywności za pomocą polecenia am i używać jego polecenia podrzędnego instrument do przeprowadzania testów.

Możesz uruchomić powłokę adb, wywołać am instrument i określić flagi wiersza poleceń w jednym wierszu wejściowym. Powłoka otwiera się na urządzeniu lub emulatorze, uruchamia testy, generuje dane wyjściowe, a następnie wraca do wiersza poleceń na komputerze.

Aby przeprowadzić test za pomocą am instrument:

1. Skompiluj lub ponownie skompiluj główną aplikację i pakiet testowy.
2. Zainstaluj pliki pakietu testowego i głównej aplikacji na Androida (pliki APK) na bieżącym urządzeniu z Androidem lub emulatorze.

3. W wierszu poleceń wpisz:

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

   gdzie <test_package_name> to nazwa pakietu Androida Twojej aplikacji testowej, a <runner_class> to nazwa używanej klasy narzędzia do testowania Androida. Nazwa pakietu na Androida to wartość atrybutu package elementu manifestu w pliku manifestu pakietu testowego (AndroidManifest.xml).

   Klasa narzędzia do uruchamiania testów na Androidzie to zwykle:AndroidJUnitRunner

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

Wyniki testu pojawią się w STDOUT.

am instrument flags

Aby wyświetlić listę wszystkich flag, których można używać z poleceniem am instrument, uruchom polecenie adb shell am help. Ważne oznaczenia są opisane w tej tabeli:

Tabela 2. Ważne am instrument flagi

am instrument options

Narzędzie am instrument przekazuje opcje testowania do AndroidJUnitRunner lub InstrumentationTestRunner w postaci par klucz-wartość, używając flagi -e, zgodnie z tą składnią:

-e <key> <value>

Niektóre klucze akceptują wiele wartości. Wiele wartości możesz podać na liście rozdzielonej przecinkami. Na przykład to wywołanie funkcji AndroidJUnitRunner podaje wiele wartości klucza package:

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

W tabeli poniżej znajdziesz pary klucz-wartość, których możesz używać w programie do uruchamiania testów:

Tabela 3. -e flag key-value pairs to use with your test runner

Podczas korzystania z flagi -e pamiętaj o tych kwestiach:

• am instrument wywołuje onCreate(Bundle) z parametrem Bundle zawierającym pary klucz-wartość.
• Klucz package ma pierwszeństwo przed kluczem class. Jeśli określisz pakiet, a potem oddzielnie określisz klasę w tym pakiecie, Android uruchomi wszystkie testy w pakiecie i zignoruje klucz klasy.
• Klucze func i unit wykluczają się nawzajem.

Przykłady użycia

W sekcjach poniżej znajdziesz przykłady użycia am instrument do przeprowadzania testów. Mają one następującą strukturę:

• Pakiet testowy ma nazwę pakietu na Androida com.android.demo.app.tests.
• Dwie klasy testów z instrumentacją:
  • TestClass1, która zawiera metodę testową testMethod1.
  • TestClass2, która zawiera metody testowe testMethod2 i testMethod3.
• Uruchamiający test to AndroidJUnitRunner.

Uruchamianie całego pakietu testów

Aby uruchomić wszystkie klasy testowe w pakiecie testowym, wpisz:

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

Uruchamianie wszystkich testów w klasie przypadków testowych

Aby uruchomić wszystkie testy w klasie TestClass1, wpisz:

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

Wybieranie podzbioru testów

Aby uruchomić wszystkie testy w klasie TestClass1 i metodzie testMethod3 w TestClass2, wpisz:

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

Więcej przypadków użycia znajdziesz w AndroidJUnitRunner dokumentacji interfejsu API.

Wyświetlanie ujednoliconych raportów z testów

Wtyczka Androida do obsługi Gradle udostępnia ujednolicone zadania raportowania testów, które generują panele HTML łączące wyniki testów jednostkowych i instrumentowanych.

Wymagania wstępne

• Wtyczka Androida do obsługi Gradle w wersji 9.2.0-alpha07 lub nowszej.

Aby wygenerować ujednolicone raporty z testów, wykonaj jedno z tych zadań: