Aufrufausführung
public
class
InvocationExecution
extends Object
implements
IInvocationExecution
java.lang.Object | |
😎 | com.android.tradefed.invoker.InvocationExecution |
Klasse, die alle Aufrufschritte beschreibt: Build-Download, target_prep, Tests ausführen, Bereinigung.
Kann erweitert werden, um das Standardverhalten einiger Schritte zu überschreiben. Die Reihenfolge der Schritte wird durch
TestInvocation
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ühren Sie die Schritte „target_preparer“ und „multi_target_preparer cleanUp“ aus. |
void
|
doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)
Führen Sie die Einrichtungsschritte „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)
Geräteprotokolle in verschiedenen Phasen des Aufrufs 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)
Versuchen Sie, die Konfiguration in Unterkonfigurationen aufzuteilen, deren Ausführung neu geplant werden soll. mehrere Ressourcen gleichzeitig ausführen. |
Geschützte Methoden | |
---|---|
void
|
collectAutoInfo(IConfiguration config, TestInformation info)
Erfassen Sie automatisch einige Informationen auf dem primären zu testenden Gerät. |
IShardHelper
|
createShardHelper()
Erstellen Sie eine Rückgabe der |
void
|
customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)
Geben Sie vor „preInvocationSetup“ die Möglichkeit, einen Teil des Geräts anzupassen. |
String
|
getAdbVersion()
Gibt die für den Aufruf verwendete ADB-Version zurück. |
|
getLabPreparersToRun(IConfiguration config, String deviceName)
Rufen Sie eine Liste der Lab-Bereitsteller ab, die auf diesem Gerät ausgeführt werden sollen. |
|
getTargetPreparersToRun(IConfiguration config, String deviceName)
Rufen Sie eine Liste der Zielvorbereitungsprogramme ab, die auf diesem Gerät ausgeführt werden sollen. |
void
|
linkExternalDirs(IBuildInfo info, TestInformation testInfo)
|
void
|
logHostAdb(IConfiguration config, ITestLogger logger)
Erfassen Sie die Logs aus $TMPDIR/adb.$UID.log. |
Throwable
|
runPreparersTearDown(TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception,
|
void
|
setTestTag(IBuildInfo info, IConfiguration config)
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 Konstruktoren
InvocationExecution
public InvocationExecution ()
Öffentliche Methoden
cleanUpBuilds
public void cleanUpBuilds (IInvocationContext context, IConfiguration config)
Führen Sie den Bereinigungsschritt "build_provider" aus. Verknüpft mit dem Build-Abruf.
Parameter | |
---|---|
context |
IInvocationContext : IInvocationContext des Aufrufs. |
config |
IConfiguration : IConfiguration dieses Testlaufs. |
doCleanUp
public void doCleanUp (IInvocationContext context, IConfiguration config, Throwable exception)
Führen Sie die Schritte „target_preparer“ und „multi_target_preparer cleanUp“ aus. Wurden die Geräte gereinigt? nach oben.
Parameter | |
---|---|
context |
IInvocationContext : IInvocationContext des Aufrufs. |
config |
IConfiguration : IConfiguration dieses Testlaufs. |
exception |
Throwable : die ursprüngliche Ausnahme, die vom laufenden Test ausgelöst wurde. |
Einrichtung
public void doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Führen Sie die Einrichtungsschritte „target_preparer“ und „multi_target_preparer“ aus. Können alle Geräte eingerichtet werden? die für den Test erforderlich sind.
Parameter | |
---|---|
testInfo |
TestInformation : TestInformation des Aufrufs. |
config |
IConfiguration : IConfiguration dieses Testlaufs. |
listener |
ITestLogger : ITestLogger zum Melden von Einrichtungsfehlerlogs. |
Ausgabe | |
---|---|
BuildError |
|
DeviceNotAvailableException |
|
TargetSetupError |
Entfernen
public void doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)
Führen Sie die Teardown-Schritte „target_preparer“ und „multi_target_preparer“ aus. Reißen die Geräte die mit der Einrichtung verbunden sind.
Parameter | |
---|---|
testInfo |
TestInformation : TestInformation des Aufrufs. |
config |
IConfiguration : IConfiguration dieses Testlaufs. |
logger |
ITestLogger : ITestLogger zum Melden von Logs. |
exception |
Throwable : die ursprüngliche Ausnahme, die vom laufenden Test 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 : TestInformation des Aufrufs. |
config |
IConfiguration : IConfiguration dieses Testlaufs. |
rescheduler |
IRescheduler : die IRescheduler zum Verschieben von Teilen des Aufrufs für
Ausführung auf einer oder mehreren anderen Ressourcen |
listener |
ITestInvocationListener : ITestInvocation zum Melden von Build-Downloadfehlern |
Returns | |
---|---|
boolean |
Der Wert ist "True", wenn der Build erfolgreich heruntergeladen wurde, andernfalls "False". |
Ausgabe | |
---|---|
BuildRetrievalError |
|
DeviceNotAvailableException |
ReportLogs
public void reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)
Geräteprotokolle in verschiedenen Phasen des Aufrufs melden. Beispiel: logcat.
Parameter | |
---|---|
device |
ITestDevice : Das Gerät, von dem Protokolle gemeldet werden sollen. |
listener |
ITestLogger : Der Logger für die Logs. |
stage |
TestInvocation.Stage : Die Aufrufphase, 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 der
.
Parameter | |
---|---|
context |
IInvocationContext : IInvocationContext des Aufrufs. |
config |
IConfiguration : IConfiguration dieses Testlaufs. |
exception |
Throwable : die ursprüngliche Ausnahme, die vom laufenden Test ausgelöst wird, 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 der
.
Parameter | |
---|---|
context |
IInvocationContext : IInvocationContext des Aufrufs. |
config |
IConfiguration : IConfiguration dieses Testlaufs. |
logger |
ITestLogger : ITestLogger zum Melden von Logs. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
runTests
public void runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)
Führt den Test aus.
Parameter | |
---|---|
info |
TestInformation : TestInformation , mit dem Tests ausgeführt werden sollen. |
config |
IConfiguration : die auszuführende IConfiguration |
listener |
ITestInvocationListener : die ITestInvocationListener der Testergebnisse |
shardConfig
public boolean shardConfig (IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
Versuchen Sie, die Konfiguration in Unterkonfigurationen aufzuteilen, deren Ausführung neu geplant werden soll. mehrere Ressourcen gleichzeitig ausführen.
Wenn die Shard-Anzahl größer als 1 ist, werden einfach Konfigurationen für jedes Shard erstellt, indem
Shard-Indizes festlegen und sie neu planen. Wenn keine Shard-Anzahl festgelegt ist,würde der Fallback auf
IShardHelper#shardConfig
Parameter | |
---|---|
config |
IConfiguration : die aktuelle IConfiguration . |
testInfo |
TestInformation : TestInformation mit den Informationen zu den Tests. |
rescheduler |
IRescheduler : die IRescheduler . |
logger |
ITestLogger : ITestLogger zum Protokollieren der Datei während der Fragmentierung. |
Returns | |
---|---|
boolean |
true, wenn der Test fragmentiert wurde. Andernfalls wird false zurückgegeben. |
Geschützte Methoden
CollectAutoInfo
protected void collectAutoInfo (IConfiguration config, TestInformation info)
Erfassen Sie automatisch einige Informationen auf dem primären zu testenden Gerät.
Parameter | |
---|---|
config |
IConfiguration |
info |
TestInformation |
Ausgabe | |
---|---|
DeviceNotAvailableException |
createShardHelper
protected IShardHelper createShardHelper ()
Erstellen Sie eine Rückgabe der IShardHelper
, die verwendet werden soll.
Returns | |
---|---|
IShardHelper |
AdjustDevicePreInvocation
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
Geben Sie vor „preInvocationSetup“ die Möglichkeit, einen Teil des Geräts 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.
Returns | |
---|---|
String |
getLabPreparersToRun
protectedgetLabPreparersToRun (IConfiguration config, String deviceName)
Rufen Sie eine Liste der Lab-Bereitsteller ab, die auf diesem Gerät ausgeführt werden sollen.
In Sandbox-Klassen überschrieben, um zu verhindern, dass Lab-Bereitsteller in der Sandbox ausgeführt werden Kind
Parameter | |
---|---|
config |
IConfiguration |
deviceName |
String |
Returns | |
---|---|
|
getTargetPreparersToRun
protectedgetTargetPreparersToRun (IConfiguration config, String deviceName)
Rufen Sie eine Liste der Zielvorbereitungsprogramme ab, die auf diesem Gerät ausgeführt werden sollen.
In Sandbox-Klassen überschrieben, um zu verhindern, dass Lab-Bereitsteller in der Sandbox ausgeführt werden Kind
Parameter | |
---|---|
config |
IConfiguration |
deviceName |
String |
Returns | |
---|---|
|
linkExternalDirs (Linkexterne Dir)
protected void linkExternalDirs (IBuildInfo info, TestInformation testInfo)
Parameter | |
---|---|
info |
IBuildInfo |
testInfo |
TestInformation |
logHostADB
protected void logHostAdb (IConfiguration config, ITestLogger logger)
Erfassen Sie die Logs aus $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)
Festlegen des Test-Tags für die Build-Informationen.
Parameter | |
---|---|
info |
IBuildInfo |
config |
IConfiguration |