AufrufAusführung
public class InvocationExecution
extends Object
implements IInvocationExecution
java.lang.Object | |
↳ | com.android.tradefed.invoker.InvocationExecution |
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 |
void | runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger) Rufen Sie |
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 |
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
protectedgetLabPreparersToRun (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
protectedgetTargetPreparersToRun (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 |