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 ein anderes Tradefed-Binärprogramm delegieren.  ParentSandboxInvocationExecution Version von InvocationExecution für die speziellen Aktionen der übergeordneten Aufrufe beim Ausführen einer Sandbox.  RemoteInvocationExecution Implementierung von InvocationExecution, die eine Remote-Ausführung steuert.  SandboxedInvocationExecution Spezielle Sandbox-Ausführung der Aufrufe: Dies ist die InvocationExection, wenn wir uns in der Sandbox befinden und den Befehl ausführen.

---

Klasse, die alle Aufrufschritte beschreibt: build download, target_prep, run tests, clean up. Kann erweitert werden, um das Standardverhalten einiger Schritte zu überschreiben. Die Reihenfolge der Schritte wird durch TestInvocation bestimmt.

Zusammenfassung

Felder
public static final String	ADB_VERSION_KEY
public static final String	JAVA_CLASSPATH_KEY
public static final 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ühre den Schritt „cleanUp“ für „target_preparer“ und „multi_target_preparer“ aus.
void	doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener) Führe die Schritte „target_preparer“ und „multi_target_preparer“ aus.
void	doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) Führen Sie die Schritte „target_preparer“ und „multi_target_preparer“ aus.
boolean	fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener) Führen Sie den Schritt „build_provider“ der Aufrufe aus.
void	reportLogs(ITestDevice device, ITestLogger listener, TestInvocation.Stage stage) Einige Geräteprotokolle in verschiedenen Phasen der Aufrufe melden.
void	runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception) Rufen Sie die ITestDevice.postInvocationTearDown(Throwable) für jeden Geräteteil des Aufrufs auf.
void	runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger) Rufen Sie die ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) für jeden Geräteteil des Aufrufs auf.
void	runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener) Führt den Test aus.
boolean	shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger) Versuch, die Konfiguration in Unterkonfigurationen aufzuteilen, die neu geplant werden, um parallel auf mehreren Ressourcen ausgeführt zu werden.

Geschützte Methoden
void	collectAutoInfo(IConfiguration config, TestInformation info) Einige Informationen zum primären Testgerät werden automatisch erfasst.
IShardHelper	createShardHelper() Erstelle die zu verwendende IShardHelper und gib sie zurück.
void	customizeDevicePreInvocation(IConfiguration config, IInvocationContext context) Sie können vor der preInvocationSetup-Funktion einige Einstellungen für das Gerät vornehmen.
String	getAdbVersion() Gibt die für die Aufrufe verwendete adb-Version zurück.
	getLabPreparersToRun(IConfiguration config, String deviceName) Liste der Lab-Vorbereitungen abrufen, die auf diesem Gerät ausgeführt werden sollen.
	getTargetPreparersToRun(IConfiguration config, String deviceName) Liste der Zielvorbereitungen 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 Protokolle unter $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

Felder

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

JAVA_VERSION_KEY

public static final String JAVA_VERSION_KEY

Ö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 des Builds.

Parameter
context	IInvocationContext: der IInvocationContext der Aufrufs.
config	IConfiguration: die IConfiguration dieses Testlaufs.

doCleanUp

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

Führe den Schritt „cleanUp“ für „target_preparer“ und „multi_target_preparer“ aus. Werden die Geräte bereinigt?

Parameter
context	IInvocationContext: der IInvocationContext der Aufrufs.
config	IConfiguration: die IConfiguration dieses Testlaufs.
exception	Throwable: Die ursprüngliche Ausnahme, die beim Ausführen des Tests geworfen wurde.

doSetup

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

Führe die Schritte „target_preparer“ und „multi_target_preparer“ aus. Sind alle Geräte eingerichtet, die für den Test erforderlich sind?

Parameter
testInfo	TestInformation: der TestInformation der Aufrufs.
config	IConfiguration: die IConfiguration dieses Testlaufs.
listener	ITestLogger: die ITestLogger, um Logs zu Einrichtungsfehlern zu melden.

Ausgabe
BuildError
DeviceNotAvailableException
TargetSetupError

doTeardown

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

Führen Sie die Schritte „target_preparer“ und „multi_target_preparer“ aus. Werden die mit der Einrichtung verbundenen Geräte heruntergefahren?

Parameter
testInfo	TestInformation: der TestInformation der Aufrufs.
config	IConfiguration: die IConfiguration dieses Testlaufs.
logger	ITestLogger: die ITestLogger, um Protokolle zu melden.
exception	Throwable: Die ursprüngliche Ausnahme, die beim Ausführen des Tests geworfen wurde.

fetchBuild

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

Führen Sie den Schritt „build_provider“ der Aufrufe aus.

Parameter
testInfo	TestInformation: der TestInformation der Aufrufs.
config	IConfiguration: die IConfiguration dieses Testlaufs.
rescheduler	IRescheduler: IRescheduler, um Teile der Aufrufe zur Ausführung auf anderen Ressourcen neu zu planen
listener	ITestInvocationListener: die ITestInvocation, um Fehler beim Herunterladen von Builds zu melden.

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äteprotokolle in verschiedenen Phasen der Aufrufe melden. Beispiel: logcat.

Parameter
device	ITestDevice: Das Gerät, von dem Protokolle gemeldet werden sollen.
listener	ITestLogger: Der Log-Logger.
stage	TestInvocation.Stage: Die Phase der Aufrufs, in der wir uns befinden.

runDevicePostInvocationTearDown

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

Rufen Sie die ITestDevice.postInvocationTearDown(Throwable) für jeden Geräteteil des Aufrufs auf.

Parameter
context	IInvocationContext: der IInvocationContext der Aufrufs.
config	IConfiguration: die IConfiguration dieses Testlaufs.
exception	Throwable: die ursprüngliche Ausnahme, die durch den Testlauf ausgelöst wurde, falls vorhanden.

runDevicePreInvocationSetup

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

Rufen Sie die ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) für jeden Geräteteil des Aufrufs auf.

Parameter
context	IInvocationContext: der IInvocationContext der Aufrufs.
config	IConfiguration: die IConfiguration dieses Testlaufs.
logger	ITestLogger: die ITestLogger, um Protokolle zu melden.

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: der zu ausführende IConfiguration
listener	ITestInvocationListener: ITestInvocationListener der Testergebnisse

shardConfig

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

Versuch, die Konfiguration in Unterkonfigurationen aufzuteilen, die neu geplant werden, um parallel auf mehreren Ressourcen ausgeführt zu werden.

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

Parameter
config	IConfiguration: der aktuelle IConfiguration.
testInfo	TestInformation: die TestInformation mit den Testinformationen.
rescheduler	IRescheduler: die IRescheduler.
logger	ITestLogger: ITestLogger wird zum Logging von Dateien während des Shardings verwendet.

Returns
boolean	„wahr“, wenn der Test in Shards ausgeführt wurde. Andernfalls wird false zurückgegeben.

Geschützte Methoden

collectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Einige Informationen zum primären Testgerät werden automatisch erfasst.

Parameter
config	IConfiguration
info	TestInformation

Ausgabe
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

Erstelle die zu verwendende IShardHelper und gib sie zurück.

Returns
IShardHelper

customizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Sie können vor der preInvocationSetup-Funktion einige Einstellungen für das Gerät vornehmen.

Parameter
config	IConfiguration: Die Konfiguration der Aufrufe.
context	IInvocationContext: Der aktuelle Aufrufkontext.

getAdbVersion

protected String getAdbVersion ()

Gibt die für die Aufrufe verwendete adb-Version zurück.

Returns
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

In Sandbox-Kursen überschrieben, um zu verhindern, dass Lab-Vorbereitungen in der Sandbox ausgeführt werden child

Parameter
config	IConfiguration
deviceName	String

Returns

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

In Sandbox-Kursen überschrieben, um zu verhindern, dass Lab-Vorbereitungen in der Sandbox ausgeführt werden child

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 Protokolle unter $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