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.

InvocationExecution

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
↳	com.android.tradefed.invoker.InvocationExecution

Bekannte direkte Unterklassen

DelegatedInvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution`, die die Ausführung an eine andere Tradefed-Binärdatei delegieren.
ParentSandboxInvocationExecution	Version von `InvocationExecution` für die speziellen Aktionen des übergeordneten Aufrufs beim Ausführen einer Sandbox.
RemoteInvocationExecution	Implementierung von `InvocationExecution`, die eine Remote-Ausführung steuert.
SandboxedInvocationExecution	Spezielle Sandbox-Ausführung des Aufrufs: Dies ist die InvocationExecution, wenn wir uns in der Sandbox befinden und den Befehl ausführen.

Klasse, die alle Aufrufschritte beschreibt: Build-Download, target_prep, Tests ausführen, Bereinigung. Kann erweitert werden, um das Standardverhalten einiger Schritte zu überschreiben. Die Reihenfolge der Schritte wird durch TestInvocation bestimmt.

Zusammenfassung

Konstanten
`String`	`ADB_VERSION_KEY`
`String`	`JAVA_CLASSPATH_KEY`
`String`	`JAVA_VERSION_KEY`

Öffentliche Konstruktoren
`InvocationExecution()`

Öffentliche Methoden
`void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Führen Sie den Bereinigungsschritt „build_provider“ aus.
`void`	`doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)` Führen Sie den cleanUp-Schritt von target_preparer und multi_target_preparer aus.
`void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)` Führen Sie den setUp-Schritt für „target_preparer“ und „multi_target_preparer“ aus.
`void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Führen Sie den Teardown-Schritt für „target_preparer“ und „multi_target_preparer“ aus.
`boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` Führen Sie den Schritt „build_provider“ des Aufrufs aus.
`void`	`reportLogs(ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)` Einige Gerätelogs in verschiedenen Phasen des Aufrufs melden.
`void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Rufen Sie `ITestDevice.postInvocationTearDown(Throwable)` für jedes Gerät auf, das Teil des Aufrufs ist.
`void`	`runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)` Rufen Sie `ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo))` für jedes Gerät auf, das Teil des Aufrufs ist.
`void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Führt den Test aus.
`boolean`	`shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` Versuchen Sie, die Konfiguration in Unterkonfigurationen aufzuteilen, die parallel auf mehreren Ressourcen ausgeführt werden sollen.

Geschützte Methoden
`void`	`collectAutoInfo(IConfiguration config, TestInformation info)` Es werden automatisch einige Informationen zum primären Gerät, das getestet wird, erhoben.
`IShardHelper`	`createShardHelper()` Erstellen Sie die zu verwendende `IShardHelper` und geben Sie sie zurück.
`void`	`customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)` Ermöglicht es, einige Geräte vor preInvocationSetup anzupassen.
`String`	`getAdbVersion()` Gibt die für den Aufruf verwendete ADB-Version zurück.
	`getLabPreparersToRun(IConfiguration config, String deviceName)` Eine Liste der Lab-Vorbereiter abrufen, die auf diesem Gerät ausgeführt werden sollen.
	`getTargetPreparersToRun(IConfiguration config, String deviceName)` Eine Liste der Zielvorbereiter abrufen, die auf diesem Gerät ausgeführt werden sollen.
`void`	`linkExternalDirs(IBuildInfo info, TestInformation testInfo)`
`void`	`logHostAdb(IConfiguration config, ITestLogger logger)` Erfassen Sie die Logs aus $TMPDIR/adb.$UID.log.
`Throwable`	`runPreparersTearDown(TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)`
`void`	`setTestTag(IBuildInfo info, IConfiguration config)` Das Test-Tag in den Build-Informationen festlegen.

Konstanten

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

Konstanter Wert: "adb_version"

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

Konstanter Wert: "java_classpath"

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Konstanter Wert: "java_version"

Öffentliche Konstruktoren

InvocationExecution

public InvocationExecution ()

Öffentliche Methoden

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Führen Sie den Bereinigungsschritt „build_provider“ aus. Im Zusammenhang mit dem Abrufen von Builds.

Parameter
`context`	`IInvocationContext`: die `IInvocationContext` des Aufrufs.
`config`	`IConfiguration`: die `IConfiguration` dieses Testlaufs.

doCleanUp

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Führen Sie den cleanUp-Schritt von target_preparer und multi_target_preparer aus. Das Gerät wird gereinigt.

Parameter
`context`	`IInvocationContext`: die `IInvocationContext` des Aufrufs.
`config`	`IConfiguration`: die `IConfiguration` dieses Testlaufs.
`exception`	`Throwable`: Die ursprüngliche Ausnahme, die vom Testlauf ausgegeben wurde.

doSetup

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

Führen Sie den setUp-Schritt für „target_preparer“ und „multi_target_preparer“ aus. Führt die gesamte für den Test erforderliche Geräteeinrichtung durch.

Parameter
`testInfo`	`TestInformation`: die `TestInformation` des Aufrufs.
`config`	`IConfiguration`: die `IConfiguration` dieses Testlaufs.
`listener`	`ITestLogger`: Die `ITestLogger` zum Melden von Einrichtungsfehlern.

Ausgabe
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

Führen Sie den Teardown-Schritt für „target_preparer“ und „multi_target_preparer“ aus. Das Gerät wird im Rahmen der Einrichtung demontiert.

Parameter
`testInfo`	`TestInformation`: die `TestInformation` des Aufrufs.
`config`	`IConfiguration`: die `IConfiguration` dieses Testlaufs.
`logger`	`ITestLogger`: Die `ITestLogger`, für die Logs gemeldet werden sollen.
`exception`	`Throwable`: Die ursprüngliche Ausnahme, die vom Testlauf ausgegeben wurde.

fetchBuild

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

Führen Sie den Schritt „build_provider“ des Aufrufs aus.

Parameter
`testInfo`	`TestInformation`: die `TestInformation` des Aufrufs.
`config`	`IConfiguration`: die `IConfiguration` dieses Testlaufs.
`rescheduler`	`IRescheduler`: die `IRescheduler`, um Teile des Aufrufs für die Ausführung auf einer anderen Ressource bzw. anderen Ressourcen neu zu planen
`listener`	`ITestInvocationListener`: die `ITestInvocation` zum Melden von Fehlern beim Herunterladen von Builds.

Returns
`boolean`	„True“, wenn der Build erfolgreich heruntergeladen wurde, andernfalls „false“.

Ausgabe
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

public void reportLogs (ITestDevice device, 
                ITestLogger listener, 
                TestInvocation.Stage stage)

Einige Gerätelogs in verschiedenen Phasen des Aufrufs melden. Beispiel: logcat.

Parameter
`device`	`ITestDevice`: Das Gerät, von dem Logs gemeldet werden sollen.
`listener`	`ITestLogger`: Der Logger für die Logs.
`stage`	`TestInvocation.Stage`: Die Phase des Aufrufs, in der wir uns befinden.

runDevicePostInvocationTearDown

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Rufen Sie ITestDevice.postInvocationTearDown(Throwable) für jedes Gerät auf, das Teil des Aufrufs ist.

Parameter
`context`	`IInvocationContext`: die `IInvocationContext` des Aufrufs.
`config`	`IConfiguration`: die `IConfiguration` dieses Testlaufs.
`exception`	`Throwable`: Die ursprüngliche Ausnahme, die vom Testlauf ausgelöst wurde, falls vorhanden.

runDevicePreInvocationSetup

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

Rufen Sie ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) für jedes Gerät auf, das Teil des Aufrufs ist.

Parameter
`context`	`IInvocationContext`: die `IInvocationContext` des Aufrufs.
`config`	`IConfiguration`: die `IConfiguration` dieses Testlaufs.
`logger`	`ITestLogger`: Die `ITestLogger`, für die Logs gemeldet werden sollen.

Ausgabe
`DeviceNotAvailableException`
`TargetSetupError`

runTests

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

Führt den Test aus.

Parameter
`info`	`TestInformation`: Die `TestInformation`, mit der Tests ausgeführt werden sollen.
`config`	`IConfiguration`: die `IConfiguration`, die ausgeführt werden soll
`listener`	`ITestInvocationListener`: die `ITestInvocationListener` der Testergebnisse

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

Versuchen Sie, die Konfiguration in Unterkonfigurationen aufzuteilen, die parallel auf mehreren Ressourcen ausgeführt werden sollen.

Wenn die Anzahl der Shards größer als 1 ist, werden einfach Konfigurationen für jeden Shard erstellt, indem die Shard-Indizes festgelegt und die Shards neu geplant werden. Wenn keine Anzahl von Shards festgelegt ist,wird standardmäßig IShardHelper.shardConfig verwendet.

Parameter
`config`	`IConfiguration`: die aktuelle `IConfiguration`.
`testInfo`	`TestInformation`: Der `TestInformation`, der die Informationen zu den Tests enthält.
`rescheduler`	`IRescheduler`: die `IRescheduler`.
`logger`	`ITestLogger`: `ITestLogger`, die zum Protokollieren von Dateien während des Shardings verwendet wird.

Returns
`boolean`	„true“, wenn der Test aufgeteilt wurde. Andernfalls wird `false` zurückgegeben.

Geschützte Methoden

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Automatische Erhebung einiger Informationen zum primären Gerät, das getestet wird.

Parameter
`config`	`IConfiguration`
`info`	`TestInformation`

Ausgabe
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

Erstellen Sie die zu verwendende IShardHelper und geben Sie sie zurück.

Returns
`IShardHelper`

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Ermöglicht es, einige Geräte vor preInvocationSetup anzupassen.

Parameter
`config`	`IConfiguration`: Die Konfiguration des Aufrufs.
`context`	`IInvocationContext`: Der aktuelle Aufrufkontext.

getAdbVersion

protected String getAdbVersion ()

Gibt die für den Aufruf verwendete ADB-Version zurück.

Returns
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Eine Liste der Lab-Vorbereiter abrufen, die auf diesem Gerät ausgeführt werden sollen.

In Sandbox-Klassen überschrieben, um zu verhindern, dass Lab-Vorbereiter im Sandbox-Child ausgeführt werden

Parameter
`config`	`IConfiguration`
`deviceName`	`String`

Returns

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Eine Liste der Zielvorbereiter abrufen, die auf diesem Gerät ausgeführt werden sollen.

In Sandbox-Klassen überschrieben, um zu verhindern, dass Lab-Vorbereiter im Sandbox-Child ausgeführt werden

Parameter
`config`	`IConfiguration`
`deviceName`	`String`

Returns

linkExternalDirs

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

Parameter
`info`	`IBuildInfo`
`testInfo`	`TestInformation`

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Erfassen Sie die Logs aus $TMPDIR/adb.$UID.log.

Parameter
`config`	`IConfiguration`
`logger`	`ITestLogger`

runPreparersTearDown

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                 preparersToRun, 
                 trackPreparersMap)

Parameter
`testInfo`	`TestInformation`
`device`	`ITestDevice`
`deviceName`	`String`
`deviceIndex`	`int`
`logger`	`ITestLogger`
`exception`	`Throwable`
`preparersToRun`
`trackPreparersMap`

Returns
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Das Test-Tag in den Build-Informationen festlegen.

Parameter
`info`	`IBuildInfo`
`config`	`IConfiguration`