Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 für den Fall, dass 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 für den Build-Anbieter 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 Einrichtungsschritt „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äteprotokolle 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 können.

Geschützte Methoden
`void`	`collectAutoInfo(IConfiguration config, TestInformation info)` Automatische Erhebung einiger Informationen zum primären Testgerät.
`IShardHelper`	`createShardHelper()` Erstellen Sie die zu verwendende `IShardHelper` und geben Sie sie zurück.
`void`	`customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)` Ermöglicht es, einige Einstellungen des Geräts vor preInvocationSetup anzupassen.
`String`	`getAdbVersion()` Gibt die für den Aufruf verwendete ADB-Version zurück.
`List<ITargetPreparer>`	`getLabPreparersToRun(IConfiguration config, String deviceName)` Eine Liste der Lab-Vorbereiter abrufen, die auf diesem Gerät ausgeführt werden sollen.
`List<ITargetPreparer>`	`getTargetPreparersToRun(IConfiguration config, String deviceName)` Eine Liste der Zielvorbereitungsprogramme 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, List<ITargetPreparer> preparersToRun, Map<String, Set<ITargetPreparer>> 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 für den Build-Anbieter 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 beim Ausführen des Tests ausgelöst wurde.

doSetup

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

Führen Sie den Einrichtungsschritt „target_preparer“ und „multi_target_preparer“ aus. Führt die gesamte Geräteeinrichtung aus, die für die Ausführung des Tests erforderlich ist.

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

Löst aus
`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 beim Ausführen des Tests ausgelöst wurde.

Löst aus
`Throwable`

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.

Gibt Folgendes zurück:
`boolean`	„True“, wenn der Build erfolgreich heruntergeladen wurde, andernfalls „false“.

Löst aus
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

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

Einige Geräteprotokolle 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.

Löst aus
`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

Löst aus
`Throwable`

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 können.

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

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

Gibt Folgendes zurück:
`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 Testgerät.

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

Löst aus
`DeviceNotAvailableException`

createShardHelper

protected IShardHelper createShardHelper ()

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

Gibt Folgendes zurück:
`IShardHelper`

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Ermöglicht es, einige Einstellungen des Geräts 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.

Gibt Folgendes zurück:
`String`

getLabPreparersToRun

protected List<ITargetPreparer> getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

Wird in Sandbox-Klassen überschrieben, um zu verhindern, dass Lab-Präparatoren im Sandbox-Child ausgeführt werden.

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

Gibt Folgendes zurück:
`List<ITargetPreparer>`

getTargetPreparersToRun

protected List<ITargetPreparer> getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

Wird in Sandbox-Klassen überschrieben, um zu verhindern, dass Lab-Präparatoren im Sandbox-Child ausgeführt werden.

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

Gibt Folgendes zurück:
`List<ITargetPreparer>`

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, 
                List<ITargetPreparer> preparersToRun, 
                Map<String, Set<ITargetPreparer>> trackPreparersMap)

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

Gibt Folgendes zurück:
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Das Test-Tag in den Build-Informationen festlegen.

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