ExecutableBaseTest

public abstract class ExecutableBaseTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IDiscoverDependencies, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

java.lang.Object
   ↳ com.android.tradefed.testtype.binary.ExecutableBaseTest


Basisklasse für ausführbare Tests. Beispiele: Binärdateien, Shell-Skripts.

Zusammenfassung

Konstanten

String NO_BINARY_ERROR

Öffentliche Konstruktoren

ExecutableBaseTest()

Öffentliche Methoden

void addAllExcludeFilters(Set<String> filters)

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

void addAllIncludeFilters(Set<String> filters)

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

void addExcludeFilter(String filter)

Fügt einen Filter hinzu, mit dem festgelegt wird, welche Tests ausgeschlossen werden sollen.

void addIncludeFilter(String filter)

Fügt einen Filter hinzu, der angibt, welche Tests einbezogen werden sollen.

void clearExcludeFilters()

Alle derzeit erfassten Ausschlussfilter löschen.

void clearIncludeFilters()

Löschen Sie alle derzeit erfassten Einschlussfilter.

abstract String findBinary(String binary)

Suchen Sie nach der Binärdatei, um sie ausführen zu können.

IAbi getAbi()

boolean getCollectTestsOnly()
Set<String> getExcludeFilters()

Gibt die aktuelle Set der Ausschlussfilter zurück.

Set<String> getIncludeFilters()

Gibt die aktuelle Set der Einschlussfilter zurück.

final long getRuntimeHint()

Gibt die erwartete Laufzeit des Tests in Millisekunden zurück.

Set<String> reportDependencies()
void run(TestInformation testInfo, ITestInvocationListener listener)

Führt die Tests aus und meldet das Ergebnis an den Listener.

abstract void runBinary(String binaryPath, ITestInvocationListener listener, TestDescription description)

Führt die Binärdatei im angegebenen Pfad aus.

final void setAbi(IAbi abi)

final void setCollectTestsOnly(boolean shouldCollectTest)

Aktiviert oder deaktiviert den Testsammlungsmodus

void setConfiguration(IConfiguration configuration)

Fügt die verwendete IConfiguration ein.

FailureDescription shouldAbortRun(TestDescription description)

Prüfen, ob der Testlauf vorzeitig beendet werden soll.

final Collection<IRemoteTest> split(int shardHint)

Alternative Version von split(), die auch die Anzahl der Shards enthält, die ausgeführt werden sollen.

Geschützte Methoden

boolean doesRunBinaryGenerateTestResults()
boolean doesRunBinaryGenerateTestRuns()
Map<String, String> getAllTestCommands()

Konvertieren Sie „mBinaryPaths“ in „mTestCommands“, um die Konsistenz zu wahren.

IConfiguration getConfiguration()

Gibt die Testkonfiguration zurück.

TestDescription[] getFilterDescriptions(Map<String, String> testCommands)
String getModuleId(IInvocationContext context)
long getTimeoutPerBinaryMs()
boolean isTestFailed(String testName)

Konstanten

NO_BINARY_ERROR

public static final String NO_BINARY_ERROR

Konstanter Wert: „Binärdatei %s ist nicht vorhanden.“

Öffentliche Konstruktoren

ExecutableBaseTest

public ExecutableBaseTest ()

Öffentliche Methoden

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

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

Parameter
filters 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

addExcludeFilter

public void addExcludeFilter (String filter)

Fügt einen Filter hinzu, mit dem festgelegt wird, welche Tests ausgeschlossen werden sollen.

Parameter
filter String

addIncludeFilter

public void addIncludeFilter (String filter)

Fügt einen Filter hinzu, der angibt, welche Tests einbezogen werden sollen.

Parameter
filter String

clearExcludeFilters

public void clearExcludeFilters ()

Alle derzeit erfassten Ausschlussfilter löschen.

clearIncludeFilters

public void clearIncludeFilters ()

Löschen Sie alle derzeit erfassten Einschlussfilter.

findBinary

public abstract String findBinary (String binary)

Suchen Sie nach der Binärdatei, um sie ausführen zu können.

Parameter
binary String: der Pfad der Binärdatei oder einfach der Name der Binärdatei.

Gibt Folgendes zurück:
String Der Pfad zur Binärdatei oder „null“, wenn sie nicht gefunden wurde.

Löst aus
DeviceNotAvailableException

getAbi

public IAbi getAbi ()

Gibt Folgendes zurück:
IAbi

getCollectTestsOnly

public boolean getCollectTestsOnly ()

Gibt Folgendes zurück:
boolean

getExcludeFilters

public Set<String> getExcludeFilters ()

Gibt die aktuelle Set der Ausschlussfilter 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 final 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

reportDependencies

public Set<String> reportDependencies ()

Gibt Folgendes zurück:
Set<String>

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

runBinary

public abstract void runBinary (String binaryPath, 
                ITestInvocationListener listener, 
                TestDescription description)

Führt die Binärdatei im angegebenen Pfad aus.

Parameter
binaryPath String: Der Pfad der Binärdatei.

listener ITestInvocationListener: Der Listener, an den die Ergebnisse gemeldet werden sollen.

description TestDescription: Der Test läuft.

Löst aus
DeviceNotAvailableException
IOException

setAbi

public final void setAbi (IAbi abi)

Parameter
abi IAbi

setCollectTestsOnly

public final void setCollectTestsOnly (boolean shouldCollectTest)

Aktiviert oder deaktiviert den Testsammlungsmodus

setConfiguration

public void setConfiguration (IConfiguration configuration)

Fügt die verwendete IConfiguration ein.

Parameter
configuration IConfiguration

shouldAbortRun

public FailureDescription shouldAbortRun (TestDescription description)

Prüfen, ob der Testlauf vorzeitig beendet werden soll.

Parameter
description TestDescription: Der Test läuft.

Gibt Folgendes zurück:
FailureDescription FailureDescription, wenn die Ausführungsschleife beendet werden soll.

teilen

public final Collection<IRemoteTest> split (int shardHint)

Alternative Version von split(), die auch die Anzahl der Shards enthält, die ausgeführt werden sollen. Dies ist für einige Testrunner nützlich, die nicht immer willkürlich entscheiden können.

Parameter
shardHint int: Die Anzahl der versuchten Shards.

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

doesRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

Gibt Folgendes zurück:
boolean

doesRunBinaryGenerateTestRuns

protected boolean doesRunBinaryGenerateTestRuns ()

Gibt Folgendes zurück:
boolean

getAllTestCommands

protected Map<String, String> getAllTestCommands ()

Konvertieren Sie „mBinaryPaths“ in „mTestCommands“, um die Konsistenz zu wahren.

Gibt Folgendes zurück:
Map<String, String> Eine MapLinkedHashMap<string, string=""> von testCommands.

</string,>

getConfiguration

protected IConfiguration getConfiguration ()

Gibt die Testkonfiguration zurück.

Gibt Folgendes zurück:
IConfiguration eine IConfiguration

getFilterDescriptions

protected TestDescription[] getFilterDescriptions (Map<String, String> testCommands)

Parameter
testCommands Map

Gibt Folgendes zurück:
TestDescription[]

getModuleId

protected String getModuleId (IInvocationContext context)

Parameter
context IInvocationContext

Gibt Folgendes zurück:
String

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

Gibt Folgendes zurück:
long Das Zeitlimit, das für die Ausführung jedes Binärprogramms gilt.

isTestFailed

protected boolean isTestFailed (String testName)

Parameter
testName String

Gibt zurück
boolean