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


Ein Test-Runner für JUnit-Host-basierte 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ügt eine ERROR(/Set) von Annotationen hinzu, die eingeschlossen werden sollen, wenn ein mit diesem gekennzeichneter Test markiert 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 Annotation hinzu, die eingeschlossen werden soll, wenn ein mit diesem gekennzeichneter Test markiert ist.

void addIncludeFilter(String filter)

Fügt einen Filter der einzuschließenden Tests hinzu.

void clearExcludeAnnotations()

Löschen Sie alle derzeit erfassten Ausschlussanmerkungen.

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 Einschließen-Filter.

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)

Injizieren Sie das zu testende Gerät.

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 Fragmentieren.

IBuildInfo getBuild()

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

ClassLoader getClassLoader()

Gibt den Standard-Classloader 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 der Klasse, die ausgeführt werden soll, und legen Sie dann einen neuen fest.

boolean shouldTestRun(AnnotatedElement annotatedElement)

Prüfen Sie, ob ein Element mit Annotation 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

addAllAusschließenAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

Fügt eine ERROR(/Set) von Annotationen hinzu, die ausgeschlossen werden sollen, wenn ein Test mit diesem 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ügt eine ERROR(/Set) von Annotationen hinzu, die eingeschlossen werden sollen, wenn ein mit diesem gekennzeichneter Test markiert ist.

Parameter
annotations

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

Parameter
filters

addAusschließenAnnotation

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)

Hier können Sie einen Filter hinzufügen, um Tests auszuschließen.

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 "Einschließen"-Filter 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, das nützliche Informationen zum Ausführen von Tests enthält.

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)

Injiziertes IConfiguration in Gebrauch.

Parameter
configuration IConfiguration

setDevice

public void setDevice (ITestDevice device)

Testgerät einschleusen

Parameter
device ITestDevice: die 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 : Liste der Optionen, die gemäß der HostTest-Set-Option formatiert sein müssen.

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 Element TestInformation

Returns
Eine Sammlung von Subtests, die separat ausgeführt werden sollen, oder null, wenn der Test derzeit nicht fragmentierbar ist

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

Ruft 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

Ladeobjekt

protected Object loadObject (Class<?> classObj)

das Klassenobjekt zu laden und die Testinformationen (device, build) festzulegen.

Parameter
classObj Class

Returns
Object

setClassName

protected void setClassName (String className)

Löschen Sie den Namen der Klasse, die ausgeführt werden soll, und legen Sie dann einen neuen 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.