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