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 invocazione: download build, target_prep, esecuzione test, pulizia. Può essere esteso per sovrascrivere il comportamento predefinito di alcuni passaggi. L'ordine dei passaggi è 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) Esegui il passaggio di pulizia build_provider. |
void | doCleanUp ( IInvocationContext context, IConfiguration config, Throwable exception) Eseguire il passaggio di pulizia target_preparer e multi_target_preparer. |
void | doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener) Eseguire il passaggio di configurazione target_preparer e multi_target_preparer. |
void | doTeardown ( TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) Esegui il passaggio di smontaggio target_preparer e multi_target_preparer. |
boolean | fetchBuild ( TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener) Esegui il passaggio build_provider dell'invocazione. |
void | reportLogs ( ITestDevice device, ITestLogger listener, TestInvocation.Stage stage) Segnala alcuni log del dispositivo in diverse fasi 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) Tentare di suddividere la configurazione in sottoconfigurazioni, da riprogrammare per l'esecuzione su più risorse in parallelo. |
Metodi protetti | |
---|---|
void | collectAutoInfo ( IConfiguration config, TestInformation info) Raccoglie automaticamente alcune informazioni sul dispositivo primario in prova. |
IShardHelper | createShardHelper () Crea un ritorno |
void | customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context) Dare la possibilità di personalizzare parte del dispositivo prima della preInvocationSetup. |
String | getAdbVersion () Restituisce la versione adb in uso per l'invocazione. |
getLabPreparersToRun ( IConfiguration config, String deviceName) Recupera un elenco di preparatori di laboratorio da eseguire su questo dispositivo. | |
getTargetPreparersToRun ( IConfiguration config, String deviceName) Recupera un elenco di preparatori di destinazione da eseguire su questo dispositivo. | |
void | logHostAdb ( IConfiguration config, ITestLogger logger) Raccogli i log da $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) Gestisci l'impostazione del tag 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)
Esegui il passaggio di pulizia build_provider. Associato al recupero della build.
Parametri | |
---|---|
context | IInvocationContext : l' IInvocationContext dell'invocazione. |
config | IConfiguration : la IConfiguration di questa esecuzione di test. |
doCleanUp
public void doCleanUp (IInvocationContext context, IConfiguration config, Throwable exception)
Eseguire il passaggio di pulizia target_preparer e multi_target_preparer. I dispositivi vengono puliti.
Parametri | |
---|---|
context | IInvocationContext : l' IInvocationContext dell'invocazione. |
config | IConfiguration : la IConfiguration di questa esecuzione di test. |
exception | Throwable : l'eccezione originale generata dal test in esecuzione. |
fareSetup
public void doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Eseguire il passaggio di configurazione target_preparer e multi_target_preparer. Esegue la configurazione di tutti i dispositivi necessari per l'esecuzione del test.
Parametri | |
---|---|
testInfo | TestInformation : TestInformation dell'invocazione. |
config | IConfiguration : la IConfiguration di questa esecuzione di test. |
listener | ITestLogger : ITestLogger per segnalare i registri degli errori di configurazione. |
Lancia | |
---|---|
BuildError | |
DeviceNotAvailableException | |
TargetSetupError |
fareTeardown
public void doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)
Esegui il passaggio di smontaggio target_preparer e multi_target_preparer. I dispositivi si smantellano associati alla configurazione.
Parametri | |
---|---|
testInfo | TestInformation : TestInformation dell'invocazione. |
config | IConfiguration : la IConfiguration di questa esecuzione di test. |
logger | ITestLogger : ITestLogger per segnalare i log. |
exception | Throwable : l'eccezione originale generata dal test in esecuzione. |
fetchBuild
public boolean fetchBuild (TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)
Esegui il passaggio build_provider dell'invocazione.
Parametri | |
---|---|
testInfo | TestInformation : TestInformation dell'invocazione. |
config | IConfiguration : la IConfiguration di questa esecuzione di test. |
rescheduler | IRescheduler : IRescheduler , per riprogrammare parti dell'invocazione per l'esecuzione su altre risorse |
listener | ITestInvocationListener : ITestInvocation per segnalare errori di download della build. |
ritorna | |
---|---|
boolean | Vero se abbiamo scaricato correttamente la build, falso altrimenti. |
Lancia | |
---|---|
BuildRetrievalError | |
DeviceNotAvailableException |
reportLogs
public void reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)
Segnala alcuni log del dispositivo in diverse fasi della chiamata. Ad esempio: logcat.
Parametri | |
---|---|
device | ITestDevice : il dispositivo da cui segnalare i log. |
listener | ITestLogger : il logger per i log. |
stage | TestInvocation.Stage : la fase dell'invocazione in cui ci troviamo. |
runDevicePostInvocationTearDown
public void runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception)
Richiamare ITestDevice#postInvocationTearDown(Throwable)
per ogni parte del dispositivo dell'invocazione.
Parametri | |
---|---|
context | IInvocationContext : l' IInvocationContext dell'invocazione. |
config | IConfiguration : la IConfiguration di questa esecuzione di test. |
exception | Throwable : l'eccezione originale generata dal test in esecuzione, se presente. |
eseguireDevicePreInvocationSetup
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 del dispositivo dell'invocazione.
Parametri | |
---|---|
context | IInvocationContext : l' IInvocationContext dell'invocazione. |
config | IConfiguration : la IConfiguration di questa esecuzione di test. |
logger | ITestLogger : ITestLogger per segnalare i log. |
Lancia | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
eseguireTest
public void runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)
Esegue il test.
Parametri | |
---|---|
info | TestInformation : TestInformation con cui eseguire i test. |
config | IConfiguration : la IConfiguration da eseguire |
listener | ITestInvocationListener : ITestInvocationListener dei risultati del test |
shardConfig
public boolean shardConfig (IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
Tentare di suddividere la configurazione in sottoconfigurazioni, da riprogrammare per l'esecuzione su più risorse in parallelo.
Se il conteggio dei frammenti è maggiore di 1, creerà semplicemente le configurazioni per ciascun frammento impostando gli indici dei frammenti e riprogrammandoli. Se non viene impostato un conteggio di shard, verrà eseguito il fallback su IShardHelper#shardConfig
.
Parametri | |
---|---|
config | IConfiguration : la IConfiguration corrente. |
testInfo | TestInformation : TestInformation che contiene le informazioni sui test. |
rescheduler | IRescheduler : l' IRescheduler . |
logger | ITestLogger : ITestLogger utilizzato per registrare il file durante lo sharding. |
ritorna | |
---|---|
boolean | true se il test è stato partizionato. Altrimenti restituisce false |
Metodi protetti
raccogliAutoInfo
protected void collectAutoInfo (IConfiguration config, TestInformation info)
Raccoglie automaticamente alcune informazioni sul dispositivo primario in prova.
Parametri | |
---|---|
config | IConfiguration |
info | TestInformation |
Lancia | |
---|---|
DeviceNotAvailableException |
createShardHelper
protected IShardHelper createShardHelper ()
Crea un ritorno IShardHelper
da utilizzare.
ritorna | |
---|---|
IShardHelper |
personalizzaDevicePreInvocation
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
Dare la possibilità di personalizzare parte del dispositivo prima della preInvocationSetup.
Parametri | |
---|---|
config | IConfiguration : la configurazione dell'invocazione. |
context | IInvocationContext : il contesto di chiamata corrente. |
getAdbVersion
protected String getAdbVersion ()
Restituisce la versione adb in uso per l'invocazione.
ritorna | |
---|---|
String |
getLabPreparersToRun
protectedgetLabPreparersToRun (IConfiguration config, String deviceName)
Recupera un elenco di preparatori di laboratorio da eseguire su questo dispositivo.
Sostituito nelle classi sandbox per impedire ai preparatori di laboratorio di essere eseguiti all'interno del figlio sandbox
Parametri | |
---|---|
config | IConfiguration |
deviceName | String |
ritorna | |
---|---|
getTargetPreparersToRun
protectedgetTargetPreparersToRun (IConfiguration config, String deviceName)
Recupera un elenco di preparatori di destinazione da eseguire su questo dispositivo.
Sostituito 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 |
runPreparersTearDown
protected Throwable runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception,preparersToRun, trackPreparersMap)
Parametri | |
---|---|
testInfo | TestInformation |
device | ITestDevice |
deviceName | String |
deviceIndex | int |
logger | ITestLogger |
exception | Throwable |
preparersToRun | |
trackPreparersMap |
ritorna | |
---|---|
Throwable |
setTestTag
protected void setTestTag (IBuildInfo info, IConfiguration config)
Gestisci l'impostazione del tag test nelle informazioni sulla build.
Parametri | |
---|---|
info | IBuildInfo |
config | IConfiguration |