AufrufAusführung

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 Sonderaktionen des übergeordneten Aufrufs beim Ausführen einer Sandbox. RemoteInvocationExecution Implementierung von InvocationExecution , die eine Remoteausführung steuert. SandboxedInvocationExecution Spezielle Sandbox-Ausführung des Aufrufs: Dies ist die InvocationExection für den Fall, dass wir uns in der Sandbox befinden und den Befehl ausführen.

---

Klasse, die alle Aufrufschritte beschreibt: Download erstellen, target_prep, Tests ausführen, bereinigen. Kann erweitert werden, um das Standardverhalten einiger Schritte zu überschreiben. Die Reihenfolge der Schritte wird von TestInvocation gesteuert.

Zusammenfassung

Felder
public static final String	ADB_VERSION_KEY
public static final String	JAVA_CLASSPATH_KEY
public static final String	JAVA_VERSION_KEY

Öffentliche Konstrukteure
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 die cleanUp-Schritte target_preparer und multi_target_preparer aus.
void	doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener) Führen Sie die setUp-Schritte target_preparer und multi_target_preparer aus.
void	doTeardown ( TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) Führen Sie die Teardown-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 des Aufrufs aus.
void	reportLogs ( ITestDevice device, ITestLogger listener, TestInvocation.Stage stage) Melden Sie einige Geräteprotokolle in verschiedenen Phasen des Aufrufs.
void	runDevicePostInvocationTearDown ( IInvocationContext context, IConfiguration config, Throwable exception) Rufen Sie ITestDevice#postInvocationTearDown(Throwable) für jeden Geräteteil des Aufrufs auf.
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 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) Versuchen Sie, die Konfiguration in Unterkonfigurationen aufzuteilen, um sie für die parallele Ausführung auf mehreren Ressourcen neu zu planen.

Geschützte Methoden
void	collectAutoInfo ( IConfiguration config, TestInformation info) Sammeln Sie automatisch einige Informationen über das primäre Testobjekt.
IShardHelper	createShardHelper () Erstellen Sie eine Rückgabe des zu verwendenden IShardHelper .
void	customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context) Geben Sie die Möglichkeit, einen Teil des Geräts vor PreInvocationSetup anzupassen.
String	getAdbVersion () Gibt die für den Aufruf verwendete adb-Version zurück.
	getLabPreparersToRun ( IConfiguration config, String deviceName) Rufen Sie eine Liste der Laborvorbereitungsprogramme ab, die auf diesem Gerät ausgeführt werden sollen.
	getTargetPreparersToRun ( IConfiguration config, String deviceName) Rufen Sie eine Liste der Zielvorbereiter ab, die auf diesem Gerät ausgeführt werden sollen.
void	logHostAdb ( IConfiguration config, ITestLogger logger) Sammeln Sie die Protokolle von $TMPDIR/adb.$UID.log.
Throwable	runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap) runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun, trackPreparersMap)
void	setTestTag ( IBuildInfo info, IConfiguration config) Behandeln Sie das Festlegen des Test-Tags für die Build-Informationen.

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 Konstrukteure

AufrufAusführung

public InvocationExecution ()

Öffentliche Methoden

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Führen Sie den Bereinigungsschritt build_provider aus. Mit dem Abrufen des Builds verbunden.

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

doCleanUp

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

Führen Sie die cleanUp-Schritte target_preparer und multi_target_preparer aus. Reinigt das Gerät.

Parameter
context	IInvocationContext : der IInvocationContext des Aufrufs.
config	IConfiguration : die IConfiguration dieses Testlaufs.
exception	Throwable : Die ursprüngliche Ausnahme, die von der Testausführung ausgelöst wurde.

doSetup

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

Führen Sie die setUp-Schritte target_preparer und multi_target_preparer aus. Führt die Einrichtung aller Geräte durch, die für die Ausführung des Tests erforderlich sind.

Parameter
testInfo	TestInformation : die TestInformation des Aufrufs.
config	IConfiguration : die IConfiguration dieses Testlaufs.
listener	ITestLogger : der ITestLogger zum Melden von Setup-Fehlerprotokollen.

Wirft
BuildError
DeviceNotAvailableException
TargetSetupError

doTeardown

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

Führen Sie die Teardown-Schritte target_preparer und multi_target_preparer aus. Werden die mit dem Setup verbundenen Geräte heruntergefahren?

Parameter
testInfo	TestInformation : die TestInformation des Aufrufs.
config	IConfiguration : die IConfiguration dieses Testlaufs.
logger	ITestLogger : der ITestLogger zum Melden von Protokollen.
exception	Throwable : Die ursprüngliche Ausnahme, die von der Testausführung ausgelöst 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 : der IRescheduler , zum Neuplanen von Teilen des Aufrufs zur Ausführung auf anderen Ressourcen
listener	ITestInvocationListener : die ITestInvocation zum Melden von Build-Download-Fehlern.

Kehrt zurück
boolean	True, wenn wir den Build erfolgreich heruntergeladen haben, andernfalls false.

Wirft
BuildRetrievalError
DeviceNotAvailableException

reportLogs

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

Melden Sie einige Geräteprotokolle in verschiedenen Phasen des Aufrufs. Zum Beispiel: logcat.

Parameter
device	ITestDevice : Das Gerät, von dem Protokolle gemeldet werden sollen.
listener	ITestLogger : Der Logger für die Protokolle.
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 jeden Geräteteil des Aufrufs auf.

Parameter
context	IInvocationContext : der IInvocationContext des Aufrufs.
config	IConfiguration : die IConfiguration dieses Testlaufs.
exception	Throwable : die ursprüngliche Ausnahme, die von der Testausführung 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 jeden Geräteteil des Aufrufs auf.

Parameter
context	IInvocationContext : der IInvocationContext des Aufrufs.
config	IConfiguration : die IConfiguration dieses Testlaufs.
logger	ITestLogger : der ITestLogger zum Melden von Protokollen.

Wirft
DeviceNotAvailableException
TargetSetupError

Tests ausführen

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

ShardConfig

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

Versuchen Sie, die Konfiguration in Unterkonfigurationen aufzuteilen, um sie für die parallele Ausführung auf mehreren Ressourcen neu zu planen.

Wenn eine Shard-Anzahl größer als 1 ist, werden einfach Konfigurationen für jeden Shard erstellt, indem Shard-Indizes festgelegt und neu geplant werden. Wenn keine Shard-Anzahl festgelegt ist, wird auf IShardHelper#shardConfig zurückgegriffen.

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

Kehrt zurück
boolean	wahr, wenn der Test geshardet wurde. Geben Sie andernfalls false zurück

Geschützte Methoden

CollectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Sammeln Sie automatisch einige Informationen über das primäre Testobjekt.

Parameter
config	IConfiguration
info	TestInformation

Wirft
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

Erstellen Sie eine Rückgabe des zu verwendenden IShardHelper .

Kehrt zurück
IShardHelper

CustomizeDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Geben Sie die Möglichkeit, einen Teil 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.

Kehrt zurück
String

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Rufen Sie eine Liste der Laborvorbereitungsprogramme ab, die auf diesem Gerät ausgeführt werden sollen.

Wird in Sandbox-Klassen überschrieben, um zu verhindern, dass Lab-Ersteller innerhalb des untergeordneten Sandbox-Objekts ausgeführt werden

Parameter
config	IConfiguration
deviceName	String

Kehrt zurück

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Rufen Sie eine Liste der Zielvorbereiter ab, die auf diesem Gerät ausgeführt werden sollen.

Wird in Sandbox-Klassen überschrieben, um zu verhindern, dass Lab-Ersteller innerhalb des untergeordneten Sandbox-Objekts ausgeführt werden

Parameter
config	IConfiguration
deviceName	String

Kehrt zurück

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Sammeln Sie die Protokolle von $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

Kehrt zurück
Throwable

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Behandeln Sie das Festlegen des Test-Tags für die Build-Informationen.

Parameter
info	IBuildInfo
config	IConfiguration