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(
Fügen Sie eine |
void
|
addAllExcludeFilters(
Fügen Sie die |
void
|
addAllIncludeAnnotation(
Fügt eine |
void
|
addAllIncludeFilters(
Fügen Sie die |
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 |
|
getExcludeFilters()
Gibt die aktuelle |
|
getIncludeAnnotations()
Gibt die aktuelle |
|
getIncludeFilters()
Gibt die aktuelle |
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 |
void
|
setDevice(ITestDevice device)
Injizieren Sie das zu testende Gerät. |
static
void
|
setOptionToLoadedObject(Object testObj,
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 |
getClassNames
publicgetClassNames ()
Returns | |
---|---|
|
getDevice
public ITestDevice getDevice ()
Holen Sie sich das Testgerät.
Returns | |
---|---|
ITestDevice |
die ITestDevice |
getExcludeAnnotations
publicgetExcludeAnnotations ()
Gibt die aktuelle ERROR(/Set)
der auszuschließenden Anmerkungen zurück.
Returns | |
---|---|
|
getExcludeFilters
publicgetExcludeFilters ()
Gibt die aktuelle ERROR(/Set)
der Ausschlüsse zurück.
Returns | |
---|---|
|
getIncludeAnnotations
publicgetIncludeAnnotations ()
Gibt die aktuelle ERROR(/Set)
der zu berücksichtigenden Anmerkungen zurück.
Returns | |
---|---|
|
getIncludeFilters
publicgetIncludeFilters ()
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 |
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
publicsplit (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 finalgetClasses ()
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. |