HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, 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 hostbasierte JUnit-Tests. Wenn der auszuführende Test IDeviceTest implementiert, gibt dieser Runner eine Referenz an das Gerät weiter.

Zusammenfassung

Felder
public static final String	SET_OPTION_DESC
public static final String	SET_OPTION_NAME

Öffentliche Konstruktoren
HostTest()

Öffentliche Methoden
void	addAllExcludeAnnotation( notAnnotations) Fügen Sie eine ERROR(/Set) mit Anmerkungen hinzu, die ausgeschlossen werden sollen, wenn ein Test damit gekennzeichnet ist.
void	addAllExcludeFilters( filters) Fügen Sie die ERROR(/Set) der Filter hinzu, deren Tests ausgeschlossen werden sollen.
void	addAllIncludeAnnotation( annotations) Fügen Sie eine ERROR(/Set) von Anmerkungen hinzu, die eingefügt werden sollen, wenn ein Test mit dieser Markierung versehen ist.
void	addAllIncludeFilters( filters) Fügen Sie die ERROR(/Set) der Filter hinzu, deren Tests eingeschlossen 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) Hiermit wird ein Filter für die Tests hinzugefügt, die ausgeschlossen werden sollen.
void	addIncludeAnnotation(String annotation) Fügt eine Anmerkung hinzu, die eingefügt werden soll, wenn ein Test entsprechend gekennzeichnet ist.
void	addIncludeFilter(String filter) Hier können Sie festlegen, welche Tests eingeschlossen werden sollen.
void	clearExcludeAnnotations() Löschen Sie alle derzeit erfassten Anmerkungen zum Ausschließen.
void	clearExcludeFilters() Löschen Sie alle derzeit erfassten Ausschlüsse.
void	clearIncludeAnnotations() Löschen Sie alle derzeit erfassten Anmerkungen vom Typ „Einschließen“.
void	clearIncludeFilters() Löschen Sie alle derzeit erfassten Einschlussfilter.
int	countTestCases() Gibt die Anzahl der Testfälle für alle Klassen zurück, die Teil der Tests sind.
IAbi	getAbi()
	getClassNames()
ITestDevice	getDevice() Holen Sie sich das Testgerät.
	getExcludeAnnotations() Gibt die aktuelle ERROR(/Set) der auszuschließenden Anmerkungen zurück.
	getExcludeFilters() Gibt die aktuelle ERROR(/Set) der Ausschlüsse zurück.
	getIncludeAnnotations() Gibt die aktuelle ERROR(/Set) der zu berücksichtigenden Anmerkungen zurück.
	getIncludeFilters() Gibt die aktuelle ERROR(/Set) der Einschlussfilter zurück.
long	getRuntimeHint() Gibt die voraussichtliche 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 Modus für die Testerhebung
void	setConfiguration(IConfiguration configuration) Fügt den verwendeten IConfiguration ein.
void	setDevice(ITestDevice device) Testgerät einschleusen
static void	setOptionToLoadedObject(Object testObj, keyValueOptions) Hilfsfunktion für Device Runners, mit der Optionen auf die gleiche Weise wie bei HostTest über „set-option“ festgelegt werden können.
void	setTestInformation(TestInformation testInfo)
	split(Integer shardCount, TestInformation testInfo) Wir unterteilen die Daten nach Testklasse oder Testmethode.

Geschützte Methoden
HostTest	createHostTest(Class<?> classObj) Hilfsfunktion 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-Klassenloader zurück.
final	getClasses()
File	getJarFile(String jarName, TestInformation testInfo) Prüfen Sie mehrere Speicherorte, an denen sich das Artefakt normalerweise für verschiedene Anwendungsfälle befindet, um das JAR-File zu finden.
boolean	hasJUnit4Annotation(Class<?> classObj) Hilft dabei zu ermitteln, ob es sich um eine Testklasse mit JUnit4-Anmerkungen 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 den Namen und legen Sie dann einen ausführbaren Klassennamen fest.
boolean	shouldTestRun(AnnotatedElement annotatedElement) Prüfen, ob ein Element mit Anmerkung den Filter besteht

Felder

SET_OPTION_DESC

public static final String SET_OPTION_DESC

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Öffentliche Konstruktoren

HostTest

public HostTest ()

Öffentliche Methoden

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

Fügen Sie eine ERROR(/Set) mit Anmerkungen hinzu, die ausgeschlossen werden sollen, wenn ein Test damit gekennzeichnet ist.

Parameter
notAnnotations

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Fügen Sie die ERROR(/Set) der Filter hinzu, deren Tests ausgeschlossen werden sollen.

Parameter
filters

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Fügen Sie eine ERROR(/Set) von Anmerkungen hinzu, die eingefügt werden sollen, wenn ein Test mit dieser Markierung versehen ist.

Parameter
annotations

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Fügen Sie die ERROR(/Set) der Filter hinzu, deren Tests eingeschlossen werden sollen.

Parameter
filters

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

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

Parameter
notAnnotation	String

addExcludeFilter

public void addExcludeFilter (String filter)

Hiermit wird ein Filter für die Tests hinzugefügt, die ausgeschlossen werden sollen.

Parameter
filter	String

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Fügt eine Anmerkung hinzu, die eingefügt werden soll, wenn ein Test entsprechend gekennzeichnet ist.

Parameter
annotation	String

addIncludeFilter

public void addIncludeFilter (String filter)

Hier können Sie festlegen, welche Tests eingeschlossen werden sollen.

Parameter
filter	String

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Löschen Sie alle derzeit erfassten Anmerkungen zum Ausschließen.

clearExcludeFilters

public void clearExcludeFilters ()

Löschen Sie alle derzeit erfassten Ausschlüsse.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Löschen Sie alle derzeit erfassten Anmerkungen vom Typ „Einschließen“.

clearIncludeFilters

public void clearIncludeFilters ()

Löschen Sie alle derzeit erfassten Einschlussfilter.

countTestCases

public int countTestCases ()

Gibt die Anzahl der Testfälle für alle Klassen zurück, die Teil der Tests sind.

Returns
int

getAbi

public IAbi getAbi ()

Returns
IAbi

getClassNames

public  getClassNames ()

Returns

getDevice

public ITestDevice getDevice ()

Holen Sie sich das Testgerä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 Ausschlüsse zurück.

Returns

getIncludeAnnotations

public  getIncludeAnnotations ()

Gibt die aktuelle ERROR(/Set) der zu berücksichtigenden Anmerkungen zurück.

Returns

getIncludeFilters

public  getIncludeFilters ()

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

Returns

getRuntimeHint

public long getRuntimeHint ()

Gibt die voraussichtliche Laufzeit des Tests in Millisekunden zurück. Die Zeit wird für das Load Balancing der ge shardeten Ausführung verwendet.

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: 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 Modus für die Testerhebung

setConfiguration

public void setConfiguration (IConfiguration configuration)

Fügt den verwendeten IConfiguration ein.

Parameter
configuration	IConfiguration

setDevice

public void setDevice (ITestDevice device)

Testgerät einschleusen

Parameter
device	ITestDevice: der zu verwendende ITestDevice

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

Hilfsfunktion für Device Runners, mit der Optionen auf die gleiche Weise wie bei HostTest über „set-option“ festgelegt werden können.

Parameter
testObj	Object: Das Objekt, das die Optionen erhält.
keyValueOptions	: Die Liste der Optionen, die gemäß der HostTest-Set-Option formatiert sein muss.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Parameter
testInfo	TestInformation

aufteilen

public  split (Integer shardCount, 
                TestInformation testInfo)

Wir unterteilen die Daten nach Testklasse oder Testmethode.

Parameter
shardCount	Integer: die Anzahl der Shards, die versucht wurden.
testInfo	TestInformation: Das übergeordnete TestInformation

Returns
	eine Sammlung von Teiltests, die separat ausgeführt werden sollen, oder null, wenn der Test derzeit nicht geShardet werden kann

Geschützte Methoden

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Hilfsfunktion zum Erstellen einer HostTest-Instanz beim Sharding. Überschreiben Sie diese Einstellung, um ein beliebiges untergeordnetes Element von „HostTest“ zurückzugeben.

Parameter
classObj	Class

Returns
HostTest

getBuild

protected IBuildInfo getBuild ()

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

Returns
IBuildInfo	die IBuildInfo

getClassLoader

protected ClassLoader getClassLoader ()

Gibt den Standard-Klassenloader zurück.

Returns
ClassLoader

getClasses

protected final  getClasses ()

Returns

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

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

Parameter
jarName	String
testInfo	TestInformation

Returns
File

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Hilft dabei zu ermitteln, ob es sich um eine Testklasse mit JUnit4-Anmerkungen 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 den Namen und legen Sie dann einen ausführbaren Klassennamen fest.

Parameter
className	String

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

Prüfen, ob ein Element mit Anmerkung den Filter besteht Für Unit-Tests freigegeben.

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