Ab 2026 werden wir den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen, um unser trunk-stable-Entwicklungsmodell zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten. Für die Entwicklung und das Beitragen zu AOSP empfehlen wir die Verwendung von android-latest-release anstelle von aosp-main. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

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

Bekannte direkte Unterklassen

ExecutableHostTest, ExecutableTargetTest

ExecutableHostTest	Test-Runner für ausführbare Dateien, die auf dem Host ausgeführt werden.
ExecutableTargetTest	Test-Runner für ausführbare Dateien, die auf dem Ziel ausgeführt werden.

Bekannte indirekte Unterklassen

KUnitModuleTest, KernelTargetTest

KUnitModuleTest	Test-Runner zum Ausführen von KUnit-Testmodulen auf dem Gerät.
KernelTargetTest	Test-Runner für ausführbare Dateien, die auf dem Ziel ausgeführt werden, und zum Parsen des Ergebnisses des Kernel-Tests.

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

Zusammenfassung

Konstanten
`String`	`NO_BINARY_ERROR`

Öffentliche Konstruktoren
`ExecutableBaseTest()`

Öffentliche Methoden
`void`	`addAllExcludeFilters( filters)` Fügt die `ERROR(/Set)` der Filter hinzu, für die Tests ausgeschlossen werden sollen.
`void`	`addAllIncludeFilters( filters)` Fügt die `ERROR(/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()` Löschen Sie alle derzeit erfassten Ausschlussfilter.
`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()`
	`getExcludeFilters()` Gibt die aktuelle `ERROR(/Set)` der Ausschlussfilter zurück.
	`getIncludeFilters()` Gibt die aktuelle `ERROR(/Set)` der Einschlussfilter zurück.
`final long`	`getRuntimeHint()` Gibt die erwartete Laufzeit des Tests in Millisekunden zurück.
	`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`	`split(int shardHint)` Alternative Version von `split()`, die auch die Anzahl der Shards angibt, die ausgeführt werden sollen.

Geschützte Methoden
`boolean`	`doesRunBinaryGenerateTestResults()`
`boolean`	`doesRunBinaryGenerateTestRuns()`
	`getAllTestCommands()` Konvertieren Sie „mBinaryPaths“ in „mTestCommands“, um die Konsistenz zu wahren.
`IConfiguration`	`getConfiguration()` Gibt die Testkonfiguration zurück.
`TestDescription[]`	`getFilterDescriptions( 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 ( filters)

Fügt die ERROR(/Set) der Filter hinzu, für die Tests ausgeschlossen werden sollen.

Parameter
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

Parameter
`filters`

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

Löschen Sie alle derzeit erfassten Ausschlussfilter.

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.

Returns
`String`	Der Pfad zur Binärdatei oder „null“, wenn sie nicht gefunden wurde.

Ausgabe
`DeviceNotAvailableException`

getAbi

public IAbi getAbi ()

Returns
`IAbi`

getCollectTestsOnly

public boolean getCollectTestsOnly ()

Returns
`boolean`

getExcludeFilters

public  getExcludeFilters ()

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

Returns

getIncludeFilters

public  getIncludeFilters ()

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

Returns

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.

Returns
`long`

reportDependencies

public  reportDependencies ()

Returns

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`

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 laufende Test.

Ausgabe
`DeviceNotAvailableException`

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 laufende Test.

Returns
`FailureDescription`	FailureDescription, wenn die Ausführungsschleife beendet werden soll.

aufteilen

public final  split (int shardHint)

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

Parameter
`shardHint`	`int`: Die Anzahl der versuchten Shards.

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

Returns
`boolean`

doesRunBinaryGenerateTestRuns

protected boolean doesRunBinaryGenerateTestRuns ()

Returns
`boolean`

getAllTestCommands

protected  getAllTestCommands ()

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

Returns
	eine Map`ERROR(/LinkedHashMap)`<string, string=""> von testCommands. </string,>

getConfiguration

protected IConfiguration getConfiguration ()

Gibt die Testkonfiguration zurück.

Returns
`IConfiguration`	eine IConfiguration

getFilterDescriptions

protected TestDescription[] getFilterDescriptions ( testCommands)

Parameter
`testCommands`

Returns
`TestDescription[]`

getModuleId

protected String getModuleId (IInvocationContext context)

Parameter
`context`	`IInvocationContext`

Returns
`String`

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

Returns
`long`	Das Zeitlimit, das für die Ausführung jedes Binärprogramms gilt.

isTestFailed

protected boolean isTestFailed (String testName)

Parameter
`testName`	`String`

Returns
`boolean`