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.

Narzędzia wiersza poleceń i zadania Gradle opisane na tej stronie są niezależne od pakietu narzędzi interfejsu. Jeśli chcesz napisać testy interfejsu Compose, przeczytaj artykuł Testowanie układu Compose. Po napisaniu testów postępuj zgodnie z tym przewodnikiem, aby uruchomić je w terminalu lub zdalnym środowisku trybu ciągłej integracji.

Gdy kompilujesz aplikację za pomocą systemu kompilacji Gradle, wtyczka Androida do obsługi Gradle umożliwia uruchamianie testów z projektu Gradle za pomocą wiersza poleceń. Aby uzyskać większą kontrolę, możesz przeprowadzać testy w powłoce Android Debug Bridge (adb). Może to być przydatne podczas przeprowadzania testów w środowisku trybu 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 informacji o tym, jak uruchamiać testy 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 rozpocząć zadanie connectedAndroidTest, wpisując to polecenie:

./gradlew cAT

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

Przeprowadzanie testów modułu

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

Przeprowadzanie testów w przypadku wariantu kompilacji

Zadania test i connectedAndroidTest przeprowadzają testy na każdym wariancie kompilacji w projekcie. Możesz kierować reklamy na konkretny wariant 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 określonych 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 na różne sposoby za pomocą skryptów powłoki.

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 uruchamiać testy za pomocą jego podpolecenia instrument.

Możesz też uruchomić powłokę adb, wywołać am instrument i określić flagi wiersza poleceń w jednym wierszu. Powłoka otworzy się na urządzeniu lub emulatorze, uruchomi testy, wygeneruje dane wyjściowe, a następnie wróci 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 na bieżącym urządzeniu z Androidem lub emulatorze pliki pakietu testowego i głównej aplikacji na Androida (pliki APK).

3. W wierszu poleceń wpisz:

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

   gdzie <test_package_name> to nazwa pakietu Android Twojej aplikacji testowej, a <runner_class> to nazwa używanej klasy narzędzia do testowania aplikacji na Androida. Nazwa pakietu 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 sekcji STDOUT.

am instrument flags

Aby wyświetlić listę wszystkich flag, których można używać z poleceniem am instrument, uruchom 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ść za pomocą flagi -e, używając tej 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 AndroidJUnitRunner podaje wiele wartości dla 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 obiektem Bundle zawierającym pary klucz-wartość.
• Klucz package ma pierwszeństwo przed kluczem class. Jeśli określisz pakiet, a potem osobno 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.
• 2 klasy testów z instrumentacją:
  • TestClass1, która zawiera metodę testowania 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 testów w pakiecie testowym, wpisz:

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

Uruchamianie wszystkich testów w klasie elementów testowania

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 AndroidJUnitRunnerdokumentacji API.

Wyświetlanie ujednoliconych raportów z testów

Wtyczka Androida do obsługi Gradle udostępnia ujednolicone zadania testowe, które generują panele HTML łączące wyniki testów jednostkowych i testów z użyciem instrumentacji.

Wymagania wstępne

• wtyczkę Androida do obsługi Gradle w wersji 9.5.0-alpha05 lub nowszej;

Aby przetestować wszystkie zestawy testów, uruchom jedno z tych zadań: