Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

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

HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, IDiscoverTestClasses, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.HostTest

Bekannte direkte Unterklassen

JarHostTest

JarHostTest Test-Runner für hostseitige JUnit-Tests.

Ein Test-Runner für JUnit-Host-basierte Tests. Wenn der auszuführende Test IDeviceTest implementiert, übergibt dieser Runner eine Referenz an das Gerät.

Zusammenfassung

Konstanten
`String`	`SET_OPTION_DESC`
`String`	`SET_OPTION_NAME`

Öffentliche Konstruktoren
`HostTest()`

Öffentliche Methoden
`void`	`addAllExcludeAnnotation(Set<String> notAnnotations)` Fügt eine `Set` von Annotationen hinzu, die ausgeschlossen werden sollen, wenn ein Test damit gekennzeichnet ist.
`void`	`addAllExcludeFilters(Set<String> filters)` Fügt die `Set` der Filter hinzu, für die Tests ausgeschlossen werden sollen.
`void`	`addAllIncludeAnnotation(Set<String> annotations)` Fügt eine `Set` von Annotationen hinzu, die eingeschlossen werden sollen, wenn ein Test damit gekennzeichnet ist.
`void`	`addAllIncludeFilters(Set<String> filters)` Fügt die `Set` der Filter hinzu, für die Tests einbezogen werden sollen.
`void`	`addExcludeAnnotation(String notAnnotation)` Fügt eine Annotation hinzu, die ausgeschlossen werden soll, wenn ein Test damit gekennzeichnet 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 gekennzeichnet 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()` Alle derzeit erfassten Ausschlussfilter löschen.
`void`	`clearIncludeAnnotations()` Alle derzeit erfassten Include-Anmerkungen löschen.
`void`	`clearIncludeFilters()` Löschen Sie alle derzeit erfassten Einschlussfilter.
`int`	`countTestCases()` Anzahl der Testläufe für alle Klassen zurückgeben, die Teil der Tests sind
`IAbi`	`getAbi()`
`Set<String>`	`getClassNames()`
`ITestDevice`	`getDevice()` Besorgen Sie sich das zu testende Gerät.
`Set<String>`	`getExcludeAnnotations()` Gibt die aktuelle `Set` der auszuschließenden Anmerkungen zurück.
`Set<String>`	`getExcludeFilters()` Gibt die aktuelle `Set` der Ausschlussfilter zurück.
`Set<String>`	`getIncludeAnnotations()` Gibt die aktuelle `Set` der einzuschließenden Anmerkungen zurück.
`Set<String>`	`getIncludeFilters()` Gibt die aktuelle `Set` der Einschlussfilter zurück.
`long`	`getRuntimeHint()` Gibt die erwartete Laufzeit des Tests in Millisekunden zurück.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Führt die Tests aus und meldet das Ergebnis an den Listener.
`void`	`setAbi(IAbi abi)`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Aktiviert oder deaktiviert den Testsammlungsmodus
`void`	`setConfiguration(IConfiguration configuration)` Fügt die verwendete `IConfiguration` ein.
`void`	`setDevice(ITestDevice device)` Schleusen Sie das zu testende Gerät ein.
`static void`	`setOptionToLoadedObject(Object testObj, List<String> keyValueOptions)` Helper für Device Runners, mit dem Optionen auf dieselbe Weise wie bei HostTest über „set-option“ festgelegt werden können.
`void`	`setTestInformation(TestInformation testInfo)`
`Collection<IRemoteTest>`	`split(Integer shardCount, TestInformation testInfo)` Wir unterteilen nach Einzelpersonen, entweder nach Testklasse oder nach Methode.

Geschützte Methoden
`HostTest`	`createHostTest(Class<?> classObj)` Hilfsklasse zum Erstellen einer HostTest-Instanz beim Sharding.
`IBuildInfo`	`getBuild()` Rufen Sie die Build-Informationen ab, die von HostTest empfangen wurden.
`ClassLoader`	`getClassLoader()` Gibt den Standard-Klassenlader zurück.
`final List<Class<?>>`	`getClasses()`
`File`	`getJarFile(String jarName, TestInformation testInfo)` Sehen Sie sich mehrere Speicherorte an, an denen sich das Artefakt normalerweise für verschiedene Anwendungsfälle befindet, um die JAR-Datei zu finden.
`boolean`	`hasJUnit4Annotation(Class<?> classObj)` Hilfsklasse, um festzustellen, ob es sich um eine Testklasse mit JUnit4-Annotationen handelt.
`Object`	`loadObject(Class<?> classObj)` Laden Sie das Klassenobjekt und legen Sie die Testinformationen (Gerät, Build) fest.
`void`	`setClassName(String className)` Löschen Sie dann den Klassennamen, der ausgeführt werden soll.
`void`	`setMethodName(String methodName)` Legen Sie den Namen der auszuführenden Methode fest.
`boolean`	`shouldTestRun(AnnotatedElement annotatedElement)` Prüfen, ob ein Element mit Annotation den Filter durchläuft.

Konstanten

SET_OPTION_DESC

public static final String SET_OPTION_DESC

Konstanter Wert: „Optionen, die an die zu testende Klasse übergeben werden sollen. Schlüssel und Wert müssen durch einen Doppelpunkt „:“ getrennt werden. Wenn die zu testende Klasse beispielsweise „--iteration 1“ über eine Befehlszeile unterstützt, sollte sie als „--set-option iteration:1“ oder „--set-option iteration:key=value“ übergeben werden, um Optionen an die Map zu übergeben. Werte, die „:“ oder „=“ enthalten, können mit einem umgekehrten Schrägstrich maskiert werden. Sie können eine bestimmte Klasse anvisieren, indem Sie sie angeben. „--set-option :

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Konstanter Wert: "set-option"

Öffentliche Konstruktoren

HostTest

public HostTest ()

Öffentliche Methoden

addAllExcludeAnnotation

public void addAllExcludeAnnotation (Set<String> notAnnotations)

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

Parameter
`notAnnotations`	`Set`

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Fügt die Set der Filter hinzu, anhand derer Tests ausgeschlossen werden sollen.

Parameter
`filters`	`Set`

addAllIncludeAnnotation

public void addAllIncludeAnnotation (Set<String> annotations)

Fügt eine Set von Annotationen hinzu, die eingeschlossen werden sollen, wenn ein Test damit gekennzeichnet ist.

Parameter
`annotations`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

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

Parameter
`filters`	`Set`

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

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

Parameter
`notAnnotation`	`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 gekennzeichnet 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 ()

Alle derzeit erfassten Ausschlussfilter löschen.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Alle derzeit erfassten Include-Anmerkungen löschen.

clearIncludeFilters

public void clearIncludeFilters ()

Löschen Sie alle derzeit erfassten Einschlussfilter.

countTestCases

public int countTestCases ()

Anzahl der Testläufe für alle Klassen zurückgeben, die Teil der Tests sind

Gibt Folgendes zurück:
`int`

getAbi

public IAbi getAbi ()

Gibt Folgendes zurück:
`IAbi`

getClassNames

public Set<String> getClassNames ()

Gibt Folgendes zurück:
`Set<String>`

getDevice

public ITestDevice getDevice ()

Besorgen Sie sich das zu testende Gerät.

Gibt Folgendes zurück:
`ITestDevice`	die `ITestDevice`

getExcludeAnnotations

public Set<String> getExcludeAnnotations ()

Gibt die aktuelle Set der auszuschließenden Anmerkungen zurück.

Gibt Folgendes zurück:
`Set<String>`

getExcludeFilters

public Set<String> getExcludeFilters ()

Gibt die aktuelle Set der Ausschlussfilter zurück.

Gibt Folgendes zurück:
`Set<String>`

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

Gibt die aktuelle Set der einzuschließenden Anmerkungen zurück.

Gibt Folgendes zurück:
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Gibt die aktuelle Set der Einschlussfilter zurück.

Gibt Folgendes zurück:
`Set<String>`

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.

Gibt Folgendes zurück:
`long`

run

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

Löst aus
`DeviceNotAvailableException`

setAbi

public void setAbi (IAbi abi)

Parameter
`abi`	`IAbi`

setBuild

public void setBuild (IBuildInfo buildInfo)

Parameter
`buildInfo`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Aktiviert oder deaktiviert den Testsammlungsmodus

setConfiguration

public void setConfiguration (IConfiguration configuration)

Fügt die verwendete IConfiguration ein.

Parameter
`configuration`	`IConfiguration`

setDevice

public void setDevice (ITestDevice device)

Schleusen Sie das zu testende Gerät ein.

Parameter
`device`	`ITestDevice`: die zu verwendende `ITestDevice`

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                List<String> keyValueOptions)

Helper für Device Runners, mit dem Optionen auf dieselbe Weise wie bei HostTest über „set-option“ festgelegt werden können.

Parameter
`testObj`	`Object`: Das Objekt, das die Optionen empfängt.
`keyValueOptions`	`List`: Die Liste der Optionen, die als HostTest-Set-Option formatiert werden müssen.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Parameter
`testInfo`	`TestInformation`

public Collection<IRemoteTest> split (Integer shardCount, 
                TestInformation testInfo)

Wir unterteilen nach Einzelpersonen, entweder nach Testklasse oder nach Methode.

Parameter
`shardCount`	`Integer`: Die Anzahl der versuchten Shards.
`testInfo`	`TestInformation`: Der übergeordnete `TestInformation`

Gibt Folgendes zurück:
`Collection<IRemoteTest>`	eine Sammlung von Untertests, die separat ausgeführt werden sollen, oder `null`, wenn der Test derzeit nicht aufgeteilt werden kann.

Geschützte Methoden

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Hilfsklasse zum Erstellen einer HostTest-Instanz beim Sharding. Überschreiben, um ein beliebiges untergeordnetes Element von HostTest zurückzugeben.

Parameter
`classObj`	`Class`

Gibt Folgendes zurück:
`HostTest`

getBuild

protected IBuildInfo getBuild ()

Rufen Sie die Build-Informationen ab, die von HostTest empfangen wurden.

Gibt Folgendes zurück:
`IBuildInfo`	die `IBuildInfo`

getClassLoader

protected ClassLoader getClassLoader ()

Gibt den Standard-Klassenlader zurück.

Gibt Folgendes zurück:
`ClassLoader`

getClasses

protected final List<Class<?>> getClasses ()

Gibt Folgendes zurück:
`List<Class<?>>`

Löst aus
`IllegalArgumentException`

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Sehen Sie sich mehrere Speicherorte an, an denen sich das Artefakt normalerweise für verschiedene Anwendungsfälle befindet, um die JAR-Datei zu finden.

Parameter
`jarName`	`String`
`testInfo`	`TestInformation`

Gibt Folgendes zurück:
`File`

Löst aus
`FileNotFoundException`

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Hilfsklasse, um festzustellen, ob es sich um eine Testklasse mit JUnit4-Annotationen handelt.

Parameter
`classObj`	`Class`

Gibt Folgendes zurück:
`boolean`

loadObject

protected Object loadObject (Class<?> classObj)

Laden Sie das Klassenobjekt und legen Sie die Testinformationen (Gerät, Build) fest.

Parameter
`classObj`	`Class`

Gibt Folgendes zurück:
`Object`

setClassName

protected void setClassName (String className)

Löschen Sie dann den Klassennamen, der ausgeführt werden soll.

Parameter
`className`	`String`

setMethodName

protected void setMethodName (String methodName)

Legen Sie den Namen der auszuführenden Methode fest.

Damit wird eine bestimmte Testmethode aus einer Testklasse ausgeführt.

Parameter
`methodName`	`String`

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

Prüfen, ob ein Element mit Annotation den Filter durchläuft. Für Einheitentests verfügbar gemacht.

Gibt Folgendes zurück:
`boolean`	„false“, wenn der Test nicht ausgeführt werden soll.