IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

Bekannte indirekte Unterklassen DelegatedInvocationExecution, InvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution DelegatedInvocationExecution InvocationExecution, die die Ausführung an eine andere Tradefed-Binärdatei delegieren.  InvocationExecution Klasse, die alle Aufrufschritte beschreibt: Build-Download, target_prep, Tests ausführen, Bereinigung.  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.

---

Schnittstelle, die die Aktionen beschreibt, die im Rahmen eines Aufrufs ausgeführt werden. Der Aufruf TestInvocation selbst sorgt für die Reihenfolge der Aufrufe.

Zusammenfassung

Öffentliche Methoden
default void	cleanUpBuilds(IInvocationContext context, IConfiguration config) Führen Sie den Bereinigungsschritt für den Build-Anbieter aus.
default void	doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception) Führen Sie den cleanUp-Schritt von target_preparer und multi_target_preparer aus.
default void	doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger) Führen Sie den Einrichtungsschritt „target_preparer“ und „multi_target_preparer“ aus.
default 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.
default boolean	fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener) Führen Sie den Schritt „build_provider“ des Aufrufs aus.
abstract void	reportLogs(ITestDevice device, ITestLogger logger, TestInvocation.Stage stage) Einige Geräteprotokolle in verschiedenen Phasen des Aufrufs melden.
default void	runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception) Rufen Sie ITestDevice.postInvocationTearDown(Throwable) für jedes Gerät auf, das Teil des Aufrufs ist.
default 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.
default void	runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener) Führt den Test aus.
default 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.

Ö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 logger)

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.
logger	ITestLogger: Die ITestLogger zum Melden von Einrichtungsfehlern.

Löst aus
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.BuildError
	com.android.tradefed.targetprep.TargetSetupError
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
	java.lang.Throwable
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
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.device.DeviceNotAvailableException
BuildRetrievalError
DeviceNotAvailableException

reportLogs

public abstract void reportLogs (ITestDevice device, 
                ITestLogger logger, 
                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.
logger	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
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.TargetSetupError
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
	java.lang.Throwable
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.