Ab 2026 werden wir den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen, um unser trunk-stable-Entwicklungsmodell zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten. Für die Entwicklung und das Beitragen zu AOSP empfehlen wir die Verwendung von android-latest-release anstelle von aosp-main. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an 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

Ein Test, der ein Instrumentierungstestpaket auf einem bestimmten Gerät mit android.support.test.runner.AndroidJUnitRunner ausführt.

Zusammenfassung

Konstanten
`String`	`EXCLUDE_COLLECTOR_FILTER_KEY`
`String`	`INCLUDE_COLLECTOR_FILTER_KEY` Optionen aus der Helper-Bibliothek auf Collector-Seite.
`String`	`NEW_RUN_LISTENER_ORDER_KEY` Argument für den Instrumentation-Testrunner, mit dem die neue `RunListener`-Reihenfolge auf dem Gerät aktiviert wird.
`String`	`USE_TEST_STORAGE_SERVICE`

Öffentliche Konstruktoren
`AndroidJUnitTest()`

Öffentliche Methoden
`void`	`addAllExcludeAnnotation( excludeAnnotations)` Fügt eine `ERROR(/Set)` von Annotationen hinzu, die ausgeschlossen werden sollen, wenn ein Test damit gekennzeichnet ist.
`void`	`addAllExcludeFilters( filters)` Fügt die `ERROR(/Set)` der Filter hinzu, für die Tests ausgeschlossen werden sollen.
`void`	`addAllIncludeAnnotation( annotations)` Fügt eine `ERROR(/Set)` von Annotationen hinzu, die einbezogen werden sollen, wenn ein Test damit gekennzeichnet ist.
`void`	`addAllIncludeFilters( filters)` Fügt die `ERROR(/Set)` der Filter hinzu, für die Tests einbezogen werden sollen.
`void`	`addExcludeAnnotation(String excludeAnnotation)` Fügt eine Annotation hinzu, die ausgeschlossen werden soll, wenn ein Test damit markiert ist.
`void`	`addExcludeFilter(String filter)` Fügt einen Filter hinzu, mit dem festgelegt wird, welche Tests ausgeschlossen werden sollen.
`void`	`addIncludeAnnotation(String annotation)` Fügt eine Anmerkung hinzu, die eingeschlossen werden soll, wenn ein Test damit markiert ist.
`void`	`addIncludeFilter(String filter)` Fügt einen Filter hinzu, der angibt, welche Tests einbezogen werden sollen.
`void`	`clearExcludeAnnotations()` Alle derzeit erfassten Ausschlussanmerkungen löschen.
`void`	`clearExcludeFilters()` Löschen Sie alle derzeit erfassten Ausschlussfilter.
`void`	`clearIncludeAnnotations()` Alle derzeit erfassten Include-Anmerkungen löschen.
`void`	`clearIncludeFilters()` Löschen Sie alle derzeit erfassten Einschlussfilter.
	`getExcludeAnnotations()` Gibt die aktuelle `ERROR(/Set)` der auszuschließenden Anmerkungen zurück.
	`getExcludeFilters()` Gibt die aktuelle `ERROR(/Set)` der Ausschlussfilter zurück.
`File`	`getExcludeTestFile()` Gibt die Datei mit den ausgeschlossenen Tests zurück.
	`getIncludeAnnotations()` Gibt die aktuelle `ERROR(/Set)` der einzuschließenden Anmerkungen zurück.
	`getIncludeFilters()` Gibt die aktuelle `ERROR(/Set)` der Einschlussfilter zurück.
`File`	`getIncludeTestFile()` Gibt die Datei mit den enthaltenen Tests zurück.
`long`	`getRuntimeHint()` Gibt die erwartete Laufzeit des Tests in Millisekunden zurück.
`boolean`	`isClassOrMethod(String filter)` Gibt zurück, ob ein String der Name einer Klasse oder Methode ist.
`boolean`	`isParameterizedTest(String filter)` Gibt zurück, ob ein String ein parametrisierter Test ist.
`boolean`	`isRegex(String filter)` Gibt zurück, ob ein String ein regulärer Ausdruck für einen Filter ist.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Führt die Tests aus und meldet das Ergebnis an den Listener.
`void`	`setExcludeTestFile(File testFile)` Legt die Testdatei für Ausschlüsse fest.
`void`	`setIncludeTestFile(File testFile)` Legt die Testdatei für Includes fest.
	`split(int shardCount)` Alternative Version von `split()`, die auch die Anzahl der Shards angibt, die ausgeführt werden sollen.

Geschützte Methoden
`void`	`setRunnerArgs(IRemoteAndroidTestRunner runner)`

Konstanten

EXCLUDE_COLLECTOR_FILTER_KEY

public static final String EXCLUDE_COLLECTOR_FILTER_KEY

Konstanter Wert: "exclude-filter-group"

INCLUDE_COLLECTOR_FILTER_KEY

public static final String INCLUDE_COLLECTOR_FILTER_KEY

Optionen aus der Helper-Bibliothek auf Collector-Seite.

Konstanter Wert: "include-filter-group"

NEW_RUN_LISTENER_ORDER_KEY

public static final String NEW_RUN_LISTENER_ORDER_KEY

Argument für den Instrumentation-Testrunner, mit dem die neue RunListener-Reihenfolge auf dem Gerät aktiviert wird.

Konstanter Wert: "newRunListenerMode"

USE_TEST_STORAGE_SERVICE

public static final String USE_TEST_STORAGE_SERVICE

Konstanter Wert: "useTestStorageService"

Öffentliche Konstruktoren

AndroidJUnitTest

public AndroidJUnitTest ()

Öffentliche Methoden

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( excludeAnnotations)

Fügt eine ERROR(/Set) von Annotationen hinzu, die ausgeschlossen werden sollen, wenn ein Test damit gekennzeichnet ist.

Parameter
`excludeAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Fügt die ERROR(/Set) der Filter hinzu, für die Tests ausgeschlossen werden sollen.

Parameter
`filters`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Fügt eine ERROR(/Set) von Annotationen hinzu, die einbezogen werden sollen, wenn ein Test damit gekennzeichnet ist.

Parameter
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Fügt die ERROR(/Set) der Filter hinzu, für die Tests einbezogen werden sollen.

Parameter
`filters`

addExcludeAnnotation

public void addExcludeAnnotation (String excludeAnnotation)

Fügt eine Annotation hinzu, die ausgeschlossen werden soll, wenn ein Test damit markiert ist.

Parameter
`excludeAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

Fügt einen Filter hinzu, mit dem festgelegt wird, welche Tests ausgeschlossen werden sollen.

Parameter
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Fügt eine Anmerkung hinzu, die eingeschlossen werden soll, wenn ein Test damit markiert ist.

Parameter
`annotation`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Fügt einen Filter hinzu, der angibt, welche Tests einbezogen werden sollen.

Parameter
`filter`	`String`

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Alle derzeit erfassten Ausschlussanmerkungen löschen.

clearExcludeFilters

public void clearExcludeFilters ()

Löschen Sie alle derzeit erfassten Ausschlussfilter.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Alle derzeit erfassten Include-Anmerkungen löschen.

clearIncludeFilters

public void clearIncludeFilters ()

Löschen Sie alle derzeit erfassten Einschlussfilter.

getExcludeAnnotations

public  getExcludeAnnotations ()

Gibt die aktuelle ERROR(/Set) der auszuschließenden Anmerkungen zurück.

Returns

getExcludeFilters

public  getExcludeFilters ()

Gibt die aktuelle ERROR(/Set) der Ausschlussfilter zurück.

Returns

getExcludeTestFile

public File getExcludeTestFile ()

Gibt die Datei mit den ausgeschlossenen Tests zurück.

Returns
`File`

getIncludeAnnotations

public  getIncludeAnnotations ()

Gibt die aktuelle ERROR(/Set) der einzuschließenden Anmerkungen zurück.

Returns

getIncludeFilters

public  getIncludeFilters ()

Gibt die aktuelle ERROR(/Set) der Einschlussfilter zurück.

Returns

getIncludeTestFile

public File getIncludeTestFile ()

Gibt die Datei mit den enthaltenen Tests zurück.

Returns
`File`

getRuntimeHint

public long getRuntimeHint ()

Gibt die erwartete Laufzeit des Tests in Millisekunden zurück. Die Zeit wird verwendet, um die Ausführung von Shards auszugleichen.

Returns
`long`

isClassOrMethod

public boolean isClassOrMethod (String filter)

Gibt zurück, ob ein String der Name einer Klasse oder einer Methode ist.

Parameter
`filter`	`String`

Returns
`boolean`

isParameterizedTest

public boolean isParameterizedTest (String filter)

Gibt zurück, ob ein String ein parametrisierter Test ist.

Parameter
`filter`	`String`

Returns
`boolean`

isRegex

public boolean isRegex (String filter)

Gibt zurück, ob ein String ein regulärer Ausdruck für einen Filter ist.

Parameter
`filter`	`String`

Returns
`boolean`

Homerun

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Führt die Tests aus und meldet das Ergebnis an den Listener.

Parameter
`testInfo`	`TestInformation`: Das `TestInformation`-Objekt mit nützlichen Informationen zum Ausführen von Tests.
`listener`	`ITestInvocationListener`: die `ITestInvocationListener` der Testergebnisse

Ausgabe
`DeviceNotAvailableException`

setExcludeTestFile

public void setExcludeTestFile (File testFile)

Legt die Testdatei für Ausschlüsse fest. Es wird nicht geprüft, ob „testFile“ vorhanden ist oder ob es sich um eine Datei handelt.

Parameter
`testFile`	`File`

setIncludeTestFile

public void setIncludeTestFile (File testFile)

Legt die Testdatei für Includes fest. Es wird nicht geprüft, ob „testFile“ vorhanden ist oder ob es sich um eine Datei handelt.

Parameter
`testFile`	`File`

aufteilen

public  split (int shardCount)

Alternative Version von split(), die auch die Anzahl der Shards angibt, die ausgeführt werden sollen. Dies ist für einige Test-Runner nützlich, die nicht immer willkürlich entscheiden können.

Parameter
`shardCount`	`int`: Die Anzahl der versuchten Shards.

Returns
	eine Sammlung von Untertests, die separat ausgeführt werden sollen, oder `null`, wenn der Test derzeit nicht aufgeteilt werden kann.

Geschützte Methoden

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parameter
`runner`	`IRemoteAndroidTestRunner`