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, Tests ausführen, Bereinigen. 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 Bauträger

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 Bereinigungsschritte „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 build_provider-Schritt 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 den 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 so zu planen, dass sie auf mehreren Ressourcen parallel ausgeführt werden.

Geschützte Methoden

void collectAutoInfo ( IConfiguration config, TestInformation info)

Sammeln Sie automatisch einige Informationen über das primär zu testende Gerät.

IShardHelper createShardHelper ()

Erstellen Sie einen Rückgabewert für den zu verwendenden IShardHelper .

void customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context)

Geben Sie vor preInvocationSetup die Möglichkeit, einige Geräte anzupassen.

String getAdbVersion ()

Gibt die für den Aufruf verwendete ADB-Version zurück.

getLabPreparersToRun ( IConfiguration config, String deviceName)

Rufen Sie eine Liste der Laborvorbereitungen 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 Bauträger

InvocationExecution

public InvocationExecution ()

Öffentliche Methoden

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Führen Sie den Bereinigungsschritt build_provider aus. Steht im Zusammenhang mit dem Build-Abruf.

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 Bereinigungsschritte „target_preparer“ und „multi_target_preparer“ aus. Bereinigt die Geräte?

Parameter
context IInvocationContext : der IInvocationContext des Aufrufs.

config IConfiguration : die IConfiguration dieses Testlaufs.

exception Throwable : Die ursprüngliche Ausnahme, die beim Testlauf 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 alle für die Ausführung des Tests erforderlichen Geräteeinstellungen durch.

Parameter
testInfo TestInformation : die TestInformation des Aufrufs.

config IConfiguration : die IConfiguration dieses Testlaufs.

listener ITestLogger : Der ITestLogger zum Melden von Setup-Fehlerprotokollen.

Würfe
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. Kommt es zu einem Ausfall der Geräte im Zusammenhang mit der Einrichtung?

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 beim Testlauf ausgelöst wurde.

fetchBuild

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

Führen Sie den build_provider-Schritt 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 einer oder mehreren anderen Ressourcen.

listener ITestInvocationListener : Der ITestInvocation zum Melden von Build-Download-Fehlern.

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

Würfe
BuildRetrievalError
DeviceNotAvailableException

reportLogs

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

Melden Sie einige Geräteprotokolle in verschiedenen Phasen des Aufrufs. 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 vom laufenden Test ausgelöst wurde, falls vorhanden.

runDevicePreInvocationSetup

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

Rufen Sie den 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.

Würfe
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 : 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 so zu planen, dass sie auf mehreren Ressourcen parallel ausgeführt werden.

Wenn die 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 mit den Informationen zu den Tests.

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 fragmentiert wurde. Andernfalls wird false zurückgegeben

Geschützte Methoden

CollectAutoInfo

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Sammeln Sie automatisch einige Informationen über das primär zu testende Gerät.

Parameter
config IConfiguration

info TestInformation

Würfe
DeviceNotAvailableException

createShardHelper

protected IShardHelper createShardHelper ()

Erstellen Sie einen Rückgabewert für den zu verwendenden IShardHelper .

Kehrt zurück
IShardHelper

anpassenDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Geben Sie vor preInvocationSetup die Möglichkeit, einige Geräte 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 Laborvorbereitungen ab, die auf diesem Gerät ausgeführt werden sollen.

Wird in Sandbox-Klassen überschrieben, um zu verhindern, dass Laborvorbereitungsprogramme 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 Laborvorbereitungsprogramme 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