Esecuzione dell'invocazione
public class InvocationExecution
extends Object
implements IInvocationExecution
java.lang.Object | |
? | com.android.tradefed.invoker.InvocationExecution |
Classe che descrive tutti i passaggi di chiamata: build download, target_prep, run test, clean up. Può essere esteso per sovrascrivere il comportamento predefinito di alcuni passaggi. Ordine dei passi è guidato da TestInvocation
.
Riepilogo
Campi | |
---|---|
public static final String | ADB_VERSION_KEY |
public static final String | JAVA_CLASSPATH_KEY |
public static final String | JAVA_VERSION_KEY
|
Costruttori pubblici | |
---|---|
InvocationExecution () |
Metodi pubblici | |
---|---|
void | cleanUpBuilds (IInvocationContext context, IConfiguration config) Eseguire il passaggio di pulizia build_provider. |
void | doCleanUp (IInvocationContext context, IConfiguration config, Throwable exception) Eseguire il passaggio target_preparer e multi_target_preparer cleanUp. |
void | doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener) Eseguire il passaggio target_preparer e multi_target_preparer setUp. |
void | doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) Eseguire il passaggio di smontaggio target_preparer e multi_target_preparer. |
boolean | fetchBuild (TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener) Eseguire il passaggio build_provider dell'invocazione. |
void | reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage) Segnala alcuni registri del dispositivo in una fase diversa della chiamata. |
void | runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception) Richiamare |
void | runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger) Richiamare |
void | runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener) Esegue il test. |
boolean | shardConfig ( IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger) Tentativo di shard la configurazione in sotto-configurazioni, da riprogrammare per l'esecuzione su più risorse in parallelo. |
Metodi protetti | |
---|---|
void | collectAutoInfo ( IConfiguration config, TestInformation info) Raccoglie automaticamente alcune informazioni sul dispositivo principale in prova. |
IShardHelper | createShardHelper () Crea un ritorno |
void | customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context) Dare la possibilità di personalizzare parte del dispositivo prima di preInvocationSetup. |
String | getAdbVersion () Restituisce la versione adb in uso per l'invocazione. |
getPreparersToRun ( IConfiguration config, String deviceName) Recupera un elenco di preparatori da eseguire su questo dispositivo. | |
void | logHostAdb ( IConfiguration config, ITestLogger logger) Raccogli i log da $TMPDIR/adb.$UID.log. |
void | runPreparersSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener) |
Throwable | runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun) runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun) |
void | setTestTag (IBuildInfo info, IConfiguration config) Gestire l'impostazione del tag di test nelle informazioni sulla build. |
Campi
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
Costruttori pubblici
Esecuzione dell'invocazione
public InvocationExecution ()
Metodi pubblici
cleanUpBuilds
public void cleanUpBuilds (IInvocationContext context, IConfiguration config)
Eseguire il passaggio di pulizia build_provider. Associato al recupero della build.
Parametri | |
---|---|
context | IInvocationContext : IInvocationContext dell'invocazione. |
config | IConfiguration : IConfiguration di questa prova. |
fareCleanUp
public void doCleanUp (IInvocationContext context, IConfiguration config, Throwable exception)
Eseguire il passaggio target_preparer e multi_target_preparer cleanUp. I dispositivi si puliscono.
Parametri | |
---|---|
context | IInvocationContext : IInvocationContext dell'invocazione. |
config | IConfiguration : IConfiguration di questa prova. |
exception | Throwable : l'eccezione originale lanciata dal test di funzionamento. |
doSetup
public void doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Eseguire il passaggio target_preparer e multi_target_preparer setUp. Esegue la configurazione di tutti i dispositivi necessari per l'esecuzione del test.
Parametri | |
---|---|
testInfo | TestInformation : la TestInformation dell'invocazione. |
config | IConfiguration : IConfiguration di questa prova. |
listener | ITestLogger : ITestLogger per segnalare errori di installazione registri. |
tiri | |
---|---|
BuildError | |
DeviceNotAvailableException | |
TargetSetupError |
fareTeardown
public void doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)
Eseguire il passaggio di smontaggio target_preparer e multi_target_preparer. I dispositivi si smontano associati alla configurazione.
Parametri | |
---|---|
testInfo | TestInformation : la TestInformation dell'invocazione. |
config | IConfiguration : IConfiguration di questa prova. |
logger | ITestLogger : ITestLogger per segnalare i registri. |
exception | Throwable : l'eccezione originale lanciata dal test di funzionamento. |
fetchBuild
public boolean fetchBuild (TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)
Eseguire il passaggio build_provider dell'invocazione.
Parametri | |
---|---|
testInfo | TestInformation : la TestInformation dell'invocazione. |
config | IConfiguration : IConfiguration di questa prova. |
rescheduler | IRescheduler : IRescheduler , per riprogrammazione porzioni di invocazione per l'esecuzione su un'altra risorsa (s) |
listener | ITestInvocationListener : ITestInvocation Per segnalare errori di compilazione di download. |
ritorna | |
---|---|
boolean | True se abbiamo scaricato correttamente la build, false altrimenti. |
tiri | |
---|---|
BuildRetrievalError | |
DeviceNotAvailableException |
reportLogs
public void reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)
Segnala alcuni registri del dispositivo in una fase diversa della chiamata. Ad esempio: logcat.
Parametri | |
---|---|
device | ITestDevice : il dispositivo per segnalare i log da. |
listener | ITestLogger : Il logger per i registri. |
stage | TestInvocation.Stage : La fase dell'invocazione siamo a. |
runDevicePostInvocationTearDown
public void runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception)
Richiamare ITestDevice#postInvocationTearDown(Throwable)
per ogni parte dispositivo dell'invocazione.
Parametri | |
---|---|
context | IInvocationContext : IInvocationContext dell'invocazione. |
config | IConfiguration : IConfiguration di questa prova. |
exception | Throwable : l'eccezione originale lanciata dal test di esecuzione se sono presenti. |
runDevicePreInvocationSetup
public void runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger)
Richiamare ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo))
per ogni parte dispositivo dell'invocazione.
Parametri | |
---|---|
context | IInvocationContext : IInvocationContext dell'invocazione. |
config | IConfiguration : IConfiguration di questa prova. |
logger | ITestLogger : ITestLogger per segnalare i registri. |
tiri | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
eseguire i test
public void runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)
Esegue il test.
Parametri | |
---|---|
info | TestInformation : il TestInformation per eseguire test con. |
config | IConfiguration : IConfiguration alla corsa |
listener | ITestInvocationListener : ITestInvocationListener dei risultati dei test |
shardConfig
public boolean shardConfig (IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
Tentativo di shard la configurazione in sotto-configurazioni, da riprogrammare per l'esecuzione su più risorse in parallelo.
Se un conteggio di shard è maggiore di 1, creerà semplicemente configurazioni per ogni shard impostando indici di shard e ripianificandoli. Se un conteggio frammento non è impostato, sarebbe, ripiegate sulla IShardHelper#shardConfig
.
Parametri | |
---|---|
config | IConfiguration : la corrente IConfiguration . |
testInfo | TestInformation : il TestInformation tiene le informazioni dei test. |
rescheduler | IRescheduler : IRescheduler . |
logger | ITestLogger : ITestLogger utilizzato per registrare file durante sharding. |
ritorna | |
---|---|
boolean | true se il test è stato partizionato. In caso contrario, il ritorno false |
Metodi protetti
raccogliAutoInfo
protected void collectAutoInfo (IConfiguration config, TestInformation info)
Raccoglie automaticamente alcune informazioni sul dispositivo principale in prova.
Parametri | |
---|---|
config | IConfiguration |
info | TestInformation |
tiri | |
---|---|
DeviceNotAvailableException |
createShardHelper
protected IShardHelper createShardHelper ()
Crea un ritorno IShardHelper
da utilizzare.
ritorna | |
---|---|
IShardHelper |
personalizzaDispositivoPreInvocazione
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
Dare la possibilità di personalizzare parte del dispositivo prima di preInvocationSetup.
Parametri | |
---|---|
config | IConfiguration : La config dell'invocazione. |
context | IInvocationContext : Il contesto invocazione corrente. |
getAdbVersion
protected String getAdbVersion ()
Restituisce la versione adb in uso per l'invocazione.
ritorna | |
---|---|
String |
getPreparersToRun
protectedgetPreparersToRun (IConfiguration config, String deviceName)
Recupera un elenco di preparatori da eseguire su questo dispositivo.
Ignorato nelle classi sandbox per impedire ai preparatori di laboratorio di essere eseguiti all'interno del figlio sandbox
Parametri | |
---|---|
config | IConfiguration |
deviceName | String |
ritorna | |
---|---|
logHostAdb
protected void logHostAdb (IConfiguration config, ITestLogger logger)
Raccogli i log da $TMPDIR/adb.$UID.log.
Parametri | |
---|---|
config | IConfiguration |
logger | ITestLogger |
runPreparersSetup
protected void runPreparersSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Parametri | |
---|---|
testInfo | TestInformation |
config | IConfiguration |
listener | ITestLogger |
tiri | |
---|---|
BuildError | |
DeviceNotAvailableException | |
TargetSetupError |
runPreparersTearDown
protected Throwable runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception,preparersToRun)
Parametri | |
---|---|
testInfo | TestInformation |
device | ITestDevice |
deviceName | String |
deviceIndex | int |
logger | ITestLogger |
exception | Throwable |
preparersToRun |
ritorna | |
---|---|
Throwable |
setTestTag
protected void setTestTag (IBuildInfo info, IConfiguration config)
Gestire l'impostazione del tag di test nelle informazioni sulla build.
Parametri | |
---|---|
info | IBuildInfo |
config | IConfiguration |