W 2026 r., aby dostosować się do naszego modelu stabilnego rozwoju trunk i zapewnić stabilność platformy w ekosystemie, będziemy publikować kod źródłowy w AOSP w drugim i czwartym kwartale. Do tworzenia i współtworzenia AOSP używaj gałęzi android-latest-release. Gałąź manifestu android-latest-release będzie zawsze odwoływać się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w artykule Zmiany w AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 zbierającego.
`String`	`NEW_RUN_LISTENER_ORDER_KEY` argument narzędzia do uruchamiania testów z instrumentacją używany do włączania nowego porządkowania `RunListener` po stronie urządzenia.
`String`	`USE_TEST_STORAGE_SERVICE`

Konstruktory publiczne
`AndroidJUnitTest()`

Metody publiczne
`void`	`addAllExcludeAnnotation(Set<String> excludeAnnotations)` Dodaje `Set` adnotacji do wykluczenia, jeśli test jest oznaczony tym symbolem.
`void`	`addAllExcludeFilters(Set<String> filters)` Dodaje `Set` filtrów określających, które testy mają zostać wykluczone.
`void`	`addAllIncludeAnnotation(Set<String> annotations)` Dodaje `Set` adnotacji do uwzględnienia, jeśli test jest oznaczony tym symbolem.
`void`	`addAllIncludeFilters(Set<String> filters)` Dodaje `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 nią oznaczony.
`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.
`Set<String>`	`getExcludeAnnotations()` Zwraca bieżący `Set` adnotacji do wykluczenia.
`Set<String>`	`getExcludeFilters()` Zwraca bieżącą `Set` filtrów wykluczeń.
`File`	`getExcludeTestFile()` Zwraca plik zawierający wykluczone testy.
`Set<String>`	`getIncludeAnnotations()` Zwraca bieżącą `Set` adnotacji do uwzględnienia.
`Set<String>`	`getIncludeFilters()` Zwraca bieżącą `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 jest testem sparametryzowanym.
`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 z dyrektywami include.
`Collection<IRemoteTest>`	`split(int shardCount)` Alternatywna wersja `split()`, która podaje 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ącego.

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

NEW_RUN_LISTENER_ORDER_KEY

public static final String NEW_RUN_LISTENER_ORDER_KEY

argument narzędzia do uruchamiania testów z instrumentacją używany do włączania nowego porządkowania 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"

Konstruktory publiczne

AndroidJUnitTest

public AndroidJUnitTest ()

Metody publiczne

addAllExcludeAnnotation

public void addAllExcludeAnnotation (Set<String> excludeAnnotations)

Dodaje Set adnotacji do wykluczenia, jeśli test jest oznaczony tym symbolem.

Parametry
`excludeAnnotations`	`Set`

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

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

Parametry
`filters`	`Set`

addAllIncludeAnnotation

public void addAllIncludeAnnotation (Set<String> annotations)

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

Parametry
`annotations`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

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

Parametry
`filters`	`Set`

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 nią oznaczony.

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 Set<String> getExcludeAnnotations ()

Zwraca bieżący Set adnotacji do wykluczenia.

Zwraca
`Set<String>`

getExcludeFilters

public Set<String> getExcludeFilters ()

Zwraca bieżącą Set filtrów wykluczeń.

Zwraca
`Set<String>`

getExcludeTestFile

public File getExcludeTestFile ()

Zwraca plik zawierający wykluczone testy.

Zwraca
`File`

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

Zwraca bieżącą Set adnotacji do uwzględnienia.

Zwraca
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Zwraca bieżącą Set filtrów uwzględniania.

Zwraca
`Set<String>`

getIncludeTestFile

public File getIncludeTestFile ()

Zwraca plik zawierający uwzględnione testy.

Zwraca
`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.

Zwraca
`long`

isClassOrMethod

public boolean isClassOrMethod (String filter)

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

Parametry
`filter`	`String`

Zwraca
`boolean`

isParameterizedTest

public boolean isParameterizedTest (String filter)

Zwraca informację, czy ciąg jest testem sparametryzowanym.

Parametry
`filter`	`String`

Zwraca
`boolean`

isRegex

public boolean isRegex (String filter)

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

Parametry
`filter`	`String`

Zwraca
`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 z dyrektywami include. Nie gwarantuje, że testFile istnieje lub jest plikiem.

Parametry
`testFile`	`File`

podziel

public Collection<IRemoteTest> split (int shardCount)

Alternatywna wersja split(), która podaje 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órych utworzenie zostało podjęte.

Zwraca
`Collection<IRemoteTest>`	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`