Aby zachować zgodność z naszym modelem rozwoju gałęzi głównej i zapewnić stabilność platformy w ekosystemie, w II i IV kwartale 2026 r. opublikujemy kod źródłowy w AOSP. Do tworzenia i współtworzenia AOSP zalecamy używanie android-latest-release zamiast aosp-main. Gałąź android-latest-release manifestu zawsze będzie odnosić się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w sekcji Zmiany w AOSP.

AndroidJUnitTest

public class AndroidJUnitTest
extends InstrumentationTest implements IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestFileFilterReceiver, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.InstrumentationTest
	↳	com.android.tradefed.testtype.AndroidJUnitTest

Test, który uruchamia pakiet testów z instrumentacją na danym urządzeniu za pomocą klasy android.support.test.runner.AndroidJUnitRunner.

Podsumowanie

Stałe
`String`	`EXCLUDE_COLLECTOR_FILTER_KEY`
`String`	`INCLUDE_COLLECTOR_FILTER_KEY` Opcje z biblioteki pomocniczej po stronie modułu zbierającego.
`String`	`NEW_RUN_LISTENER_ORDER_KEY` argument narzędzia do uruchamiania testów instrumentacji używany do włączania nowego porządku `RunListener` po stronie urządzenia.
`String`	`USE_TEST_STORAGE_SERVICE`

Publiczne konstruktory
`AndroidJUnitTest()`

Metody publiczne
`void`	`addAllExcludeAnnotation( excludeAnnotations)` Dodaje `ERROR(/Set)` adnotacji do wykluczenia, jeśli test jest oznaczony tym symbolem.
`void`	`addAllExcludeFilters( filters)` Dodaje `ERROR(/Set)` filtrów, które określają, które testy mają zostać wykluczone.
`void`	`addAllIncludeAnnotation( annotations)` Dodaje `ERROR(/Set)` adnotacji do uwzględnienia, jeśli test jest oznaczony tym symbolem.
`void`	`addAllIncludeFilters( filters)` Dodaje `ERROR(/Set)` filtrów, które określają, jakie testy mają być uwzględnione.
`void`	`addExcludeAnnotation(String excludeAnnotation)` Dodaje adnotację do wykluczenia, jeśli testy są nią oznaczone.
`void`	`addExcludeFilter(String filter)` Dodaje filtr określający, które testy mają zostać wykluczone.
`void`	`addIncludeAnnotation(String annotation)` Dodaje adnotację, która ma być uwzględniana, jeśli test jest oznaczony tą adnotacją.
`void`	`addIncludeFilter(String filter)` Dodaje filtr określający, które testy mają być uwzględnione.
`void`	`clearExcludeAnnotations()` Usuń wszystkie aktualnie śledzone adnotacje wykluczeń.
`void`	`clearExcludeFilters()` Usuń wszystkie obecnie śledzone filtry wykluczeń.
`void`	`clearIncludeAnnotations()` Usuń wszystkie obecnie śledzone adnotacje dotyczące uwzględniania.
`void`	`clearIncludeFilters()` Usuń wszystkie obecnie śledzone filtry uwzględniania.
	`getExcludeAnnotations()` Zwraca bieżącą `ERROR(/Set)` adnotacji do wykluczenia.
	`getExcludeFilters()` Zwraca bieżącą `ERROR(/Set)` filtrów wykluczeń.
`File`	`getExcludeTestFile()` Zwraca plik zawierający wykluczone testy.
	`getIncludeAnnotations()` Zwraca bieżącą `ERROR(/Set)` adnotacji do uwzględnienia.
	`getIncludeFilters()` Zwraca bieżący `ERROR(/Set)` filtrów uwzględniania.
`File`	`getIncludeTestFile()` Zwraca plik zawierający uwzględnione testy.
`long`	`getRuntimeHint()` Zwraca oczekiwany czas działania testu w milisekundach.
`boolean`	`isClassOrMethod(String filter)` Zwraca informację, czy ciąg znaków jest nazwą klasy lub metody.
`boolean`	`isParameterizedTest(String filter)` Zwraca informację, czy ciąg znaków jest testem parametryzowanym.
`boolean`	`isRegex(String filter)` Zwraca informację, czy ciąg znaków jest wyrażeniem regularnym dla filtra.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Przeprowadza testy i przekazuje wyniki odbiorcy.
`void`	`setExcludeTestFile(File testFile)` Ustawia plik testowy wykluczeń.
`void`	`setIncludeTestFile(File testFile)` Ustawia plik testowy dołączanych plików.
	`split(int shardCount)` Alternatywna wersja `split()`, która zawiera też liczbę fragmentów, które mają zostać uruchomione.

Metody chronione
`void`	`setRunnerArgs(IRemoteAndroidTestRunner runner)`

Stałe

EXCLUDE_COLLECTOR_FILTER_KEY

public static final String EXCLUDE_COLLECTOR_FILTER_KEY

Wartość stała: "exclude-filter-group"

INCLUDE_COLLECTOR_FILTER_KEY

public static final String INCLUDE_COLLECTOR_FILTER_KEY

Opcje z biblioteki pomocniczej po stronie zbierającej dane.

Stała wartość: "include-filter-group"

NEW_RUN_LISTENER_ORDER_KEY

public static final String NEW_RUN_LISTENER_ORDER_KEY

argument narzędzia do uruchamiania testów instrumentacji używany do włączania nowego porządku RunListener po stronie urządzenia.

Wartość stała: "newRunListenerMode"

USE_TEST_STORAGE_SERVICE

public static final String USE_TEST_STORAGE_SERVICE

Wartość stała: "useTestStorageService"

Publiczne konstruktory

AndroidJUnitTest

public AndroidJUnitTest ()

Metody publiczne

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( excludeAnnotations)

Dodaje ERROR(/Set) adnotacji do wykluczenia, jeśli test jest oznaczony tym symbolem.

Parametry
`excludeAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Dodaje ERROR(/Set) filtrów, które określają, które testy mają zostać wykluczone.

Parametry
`filters`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Dodaje ERROR(/Set) adnotacji do uwzględnienia, jeśli test jest oznaczony tym symbolem.

Parametry
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Dodaje ERROR(/Set) filtrów, które określają, jakie testy mają być uwzględnione.

Parametry
`filters`

addExcludeAnnotation

public void addExcludeAnnotation (String excludeAnnotation)

Dodaje adnotację do wykluczenia, jeśli testy są nią oznaczone.

Parametry
`excludeAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

Dodaje filtr określający, które testy mają zostać wykluczone.

Parametry
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Dodaje adnotację, która ma być uwzględniana, jeśli test jest oznaczony tą adnotacją.

Parametry
`annotation`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Dodaje filtr określający, które testy mają być uwzględnione.

Parametry
`filter`	`String`

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Usuń wszystkie aktualnie śledzone adnotacje wykluczeń.

clearExcludeFilters

public void clearExcludeFilters ()

Usuń wszystkie obecnie śledzone filtry wykluczeń.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Usuń wszystkie obecnie śledzone adnotacje dotyczące uwzględniania.

clearIncludeFilters

public void clearIncludeFilters ()

Usuń wszystkie obecnie śledzone filtry uwzględniania.

getExcludeAnnotations

public  getExcludeAnnotations ()

Zwraca bieżącą ERROR(/Set) adnotacji do wykluczenia.

Zwroty

getExcludeFilters

public  getExcludeFilters ()

Zwraca bieżącą ERROR(/Set) filtrów wykluczeń.

Zwroty

getExcludeTestFile

public File getExcludeTestFile ()

Zwraca plik zawierający wykluczone testy.

Zwroty
`File`

getIncludeAnnotations

public  getIncludeAnnotations ()

Zwraca bieżącą ERROR(/Set) adnotacji do uwzględnienia.

Zwroty

getIncludeFilters

public  getIncludeFilters ()

Zwraca bieżący ERROR(/Set) filtrów uwzględniania.

Zwroty

getIncludeTestFile

public File getIncludeTestFile ()

Zwraca plik zawierający uwzględnione testy.

Zwroty
`File`

getRuntimeHint

public long getRuntimeHint ()

Zwraca oczekiwany czas działania testu w milisekundach. Ten czas jest używany do równoważenia obciążenia podczas wykonywania podzielonego na fragmenty.

Zwroty
`long`

isClassOrMethod

public boolean isClassOrMethod (String filter)

Zwraca informację, czy ciąg znaków jest nazwą klasy lub metody.

Parametry
`filter`	`String`

Zwroty
`boolean`

isParameterizedTest

public boolean isParameterizedTest (String filter)

Zwraca informację, czy ciąg znaków jest testem parametryzowanym.

Parametry
`filter`	`String`

Zwroty
`boolean`

isRegex

public boolean isRegex (String filter)

Zwraca informację, czy ciąg znaków jest wyrażeniem regularnym dla filtra.

Parametry
`filter`	`String`

Zwroty
`boolean`

home run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Przeprowadza testy i przekazuje wyniki odbiorcy.

Parametry
`testInfo`	`TestInformation`: Obiekt `TestInformation` zawierający przydatne informacje do przeprowadzania testów.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` wyników testu

Zgłasza
`DeviceNotAvailableException`

setExcludeTestFile

public void setExcludeTestFile (File testFile)

Ustawia plik testowy wykluczeń. Nie gwarantuje, że testFile istnieje lub jest plikiem.

Parametry
`testFile`	`File`

setIncludeTestFile

public void setIncludeTestFile (File testFile)

Ustawia plik testowy dołączanych plików. Nie gwarantuje, że testFile istnieje lub jest plikiem.

Parametry
`testFile`	`File`

podziel

public  split (int shardCount)

Alternatywna wersja split(), która zawiera też liczbę fragmentów, które mają zostać uruchomione. Jest to przydatne w przypadku niektórych programów do uruchamiania testów, które nie mogą czasami podejmować arbitralnych decyzji.

Parametry
`shardCount`	`int`: liczba fragmentów, które próbowano utworzyć.

Zwroty
	zbiór podtestów do wykonania osobno lub `null`, jeśli test nie jest obecnie podzielony na części.

Metody chronione

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parametry
`runner`	`IRemoteAndroidTestRunner`