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 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