Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.

Diese Seite wurde von der Cloud Translation API übersetzt.

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( notAnnotations)` 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 notAnnotation)` Fügt eine Anmerkung 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()` 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.
`int`	`countTestCases()` Anzahl der Testläufe in allen Klassen zurückgeben, die Teil der Tests sind
`IAbi`	`getAbi()`
	`getClassNames()`
`ITestDevice`	`getDevice()` Besorgen Sie sich das zu testende Gerät.
	`getExcludeAnnotations()` Gibt die aktuelle `ERROR(/Set)` der auszuschließenden Anmerkungen zurück.
	`getExcludeFilters()` Gibt die aktuelle `ERROR(/Set)` der Ausschlussfilter zurück.
	`getIncludeAnnotations()` Gibt die aktuelle `ERROR(/Set)` der einzuschließenden Anmerkungen zurück.
	`getIncludeFilters()` Gibt die aktuelle `ERROR(/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)` Schließe das zu testende Gerät an.
`static void`	`setOptionToLoadedObject(Object testObj, 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)`
	`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()` Ruft die von HostTest empfangenen Build-Informationen ab.
`ClassLoader`	`getClassLoader()` Gibt den Standard-Klassenlader zurück.
`final`	`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, und legen Sie ihn 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 ( notAnnotations)

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

Parameter
`notAnnotations`

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 notAnnotation)

Fügt eine Annotation hinzu, die ausgeschlossen werden soll, wenn ein Test damit markiert 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 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.

countTestCases

public int countTestCases ()

Anzahl der Testläufe in allen Klassen zurückgeben, die Teil der Tests sind

Returns
`int`

getAbi

public IAbi getAbi ()

Returns
`IAbi`

getClassNames

public  getClassNames ()

Returns

getDevice

public ITestDevice getDevice ()

Besorgen Sie sich das zu testende Gerät.

Returns
`ITestDevice`	die `ITestDevice`

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

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

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`

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`

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)

Schließe das zu testende Gerät an.

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

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 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`	: Die Liste der Optionen, die als HostTest-Set-Option formatiert werden müssen.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Parameter
`testInfo`	`TestInformation`

aufteilen

public  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`

Returns
	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`

Returns
`HostTest`

getBuild

protected IBuildInfo getBuild ()

Ruft die von HostTest empfangenen Build-Informationen ab.

Returns
`IBuildInfo`	die `IBuildInfo`

getClassLoader

protected ClassLoader getClassLoader ()

Gibt den Standard-Klassenlader zurück.

Returns
`ClassLoader`

getClasses

protected final  getClasses ()

Returns

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`

Returns
`File`

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

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

Parameter
`classObj`	`Class`

Returns
`boolean`

loadObject

protected Object loadObject (Class<?> classObj)

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

Parameter
`classObj`	`Class`

Returns
`Object`

setClassName

protected void setClassName (String className)

Löschen Sie dann den Klassennamen, der ausgeführt werden soll, und legen Sie ihn fest.

Parameter
`className`	`String`

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

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

Returns
`boolean`	„false“, wenn der Test nicht ausgeführt werden soll.