InvocationExecution
public
class
InvocationExecution
extends Object
implements
IInvocationExecution
java.lang.Object | |
↳ | com.android.tradefed.invoker.InvocationExecution |
Classe che descrive tutti i passaggi di chiamata: download della compilazione, preparazione del target, esecuzione dei test, pulizia.
Può essere esteso per ignorare il comportamento predefinito di alcuni passaggi. L'ordine dei passaggi è determinato 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)
Esegui il passaggio di pulizia di target_preparer e multi_target_preparer. |
void
|
doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)
Esegui il passaggio di configurazione di target_preparer e multi_target_preparer. |
void
|
doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)
Esegui il passaggio di smantellamento di 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)
Genera report su alcuni log del dispositivo in fasi diverse dell'invocazione. |
void
|
runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)
Richiama |
void
|
runDevicePreInvocationSetup(IInvocationContext context, IConfiguration config, ITestLogger logger)
Richiama |
void
|
runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)
Esegue il test. |
boolean
|
shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
Prova a suddividere la configurazione in sottoconfigurazioni, da riprogrammare per l'esecuzione su più risorse in parallelo. |
Metodi protetti | |
---|---|
void
|
collectAutoInfo(IConfiguration config, TestInformation info)
Raccogliere automaticamente alcune informazioni sul dispositivo principale in test. |
IShardHelper
|
createShardHelper()
Crea un valore restituito |
void
|
customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)
Offri la possibilità di personalizzare alcune parti del dispositivo prima di preInvocationSetup. |
String
|
getAdbVersion()
Restituisce la versione di adb in uso per l'invocazione. |
|
getLabPreparersToRun(IConfiguration config, String deviceName)
Recupera un elenco di preparatori di lab da eseguire su questo dispositivo. |
|
getTargetPreparersToRun(IConfiguration config, String deviceName)
Recupera un elenco di preparatori target da eseguire su questo dispositivo. |
void
|
linkExternalDirs(IBuildInfo info, TestInformation testInfo)
|
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,
|
void
|
setTestTag(IBuildInfo info, IConfiguration config)
Gestisci l'impostazione del tag di test nelle informazioni sulla compilazione. |
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
InvocationExecution
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 : il IInvocationContext della chiamata. |
config |
IConfiguration : il IConfiguration di questa esecuzione di test. |
doCleanUp
public void doCleanUp (IInvocationContext context, IConfiguration config, Throwable exception)
Esegui il passaggio di pulizia di target_preparer e multi_target_preparer. I dispositivi si ripuliscono.
Parametri | |
---|---|
context |
IInvocationContext : il IInvocationContext della chiamata. |
config |
IConfiguration : il IConfiguration di questa esecuzione di test. |
exception |
Throwable : l'eccezione originale lanciata dal test in esecuzione. |
doSetup
public void doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Esegui il passaggio di configurazione di target_preparer e multi_target_preparer. Configura tutti i dispositivi necessari per l'esecuzione del test.
Parametri | |
---|---|
testInfo |
TestInformation : il TestInformation della chiamata. |
config |
IConfiguration : il IConfiguration di questa esecuzione di test. |
listener |
ITestLogger : il ITestLogger per segnalare i log relativi agli errori di configurazione. |
Lanci | |
---|---|
BuildError |
|
DeviceNotAvailableException |
|
TargetSetupError |
doTeardown
public void doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)
Esegui il passaggio di smantellamento di target_preparer e multi_target_preparer. I dispositivi associati alla configurazione vengono ritirati?
Parametri | |
---|---|
testInfo |
TestInformation : il TestInformation della chiamata. |
config |
IConfiguration : il IConfiguration di questa esecuzione di test. |
logger |
ITestLogger : il ITestLogger per generare i log. |
exception |
Throwable : l'eccezione originale lanciata 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 : il TestInformation della chiamata. |
config |
IConfiguration : il IConfiguration di questa esecuzione di test. |
rescheduler |
IRescheduler : il IRescheduler , per riprogrammare parti dell'invocazione per
l'esecuzione su altre risorse |
listener |
ITestInvocationListener : il ITestInvocation per segnalare i problemi di download della build. |
Ritorni | |
---|---|
boolean |
Vero se abbiamo scaricato correttamente la build, falso in caso contrario. |
Lanci | |
---|---|
BuildRetrievalError |
|
DeviceNotAvailableException |
reportLogs
public void reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)
Genera report su alcuni log del dispositivo in fasi diverse dell'invocazione. Ad esempio: logcat.
Parametri | |
---|---|
device |
ITestDevice : il dispositivo da cui generare 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)
Richiama ITestDevice.postInvocationTearDown(Throwable)
per ogni parte del dispositivo dell' invocazione.
Parametri | |
---|---|
context |
IInvocationContext : il IInvocationContext della chiamata. |
config |
IConfiguration : il IConfiguration di questa esecuzione di test. |
exception |
Throwable : l'eventuale eccezione originale lanciata dal test in esecuzione. |
runDevicePreInvocationSetup
public void runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger)
Richiama 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 : il IInvocationContext della chiamata. |
config |
IConfiguration : il IConfiguration di questa esecuzione di test. |
logger |
ITestLogger : il ITestLogger per generare i log. |
Lanci | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
runTests
public void runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)
Esegue il test.
Parametri | |
---|---|
info |
TestInformation : il TestInformation con cui eseguire i test. |
config |
IConfiguration : il IConfiguration da eseguire |
listener |
ITestInvocationListener : il ITestInvocationListener dei risultati del test |
shardConfig
public boolean shardConfig (IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
Prova a suddividere la configurazione in sottoconfigurazioni, da riprogrammare per l'esecuzione su più risorse in parallelo.
Se il numero di shard è maggiore di 1, verranno semplicemente create le configurazioni per ogni shard impostando gli indici dei shard e riprogrammandoli. Se non è impostato un numero di shard,verrà utilizzato il valore IShardHelper.shardConfig
.
Parametri | |
---|---|
config |
IConfiguration : l'attuale IConfiguration . |
testInfo |
TestInformation : il TestInformation che detiene le informazioni sui test. |
rescheduler |
IRescheduler : il IRescheduler . |
logger |
ITestLogger : ITestLogger utilizzato per registrare il file durante lo sharding. |
Ritorni | |
---|---|
boolean |
true se il test è stato suddiviso in parti. In caso contrario, restituisce false |
Metodi protetti
collectAutoInfo
protected void collectAutoInfo (IConfiguration config, TestInformation info)
Raccogliere automaticamente alcune informazioni sul dispositivo principale in test.
Parametri | |
---|---|
config |
IConfiguration |
info |
TestInformation |
Lanci | |
---|---|
DeviceNotAvailableException |
createShardHelper
protected IShardHelper createShardHelper ()
Crea un valore restituito IShardHelper
da utilizzare.
Ritorni | |
---|---|
IShardHelper |
customizeDevicePreInvocation
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
Offri la possibilità di personalizzare alcune parti del dispositivo prima di preInvocationSetup.
Parametri | |
---|---|
config |
IConfiguration : la configurazione dell'invocazione. |
context |
IInvocationContext : il contesto di chiamata corrente. |
getAdbVersion
protected String getAdbVersion ()
Restituisce la versione di adb in uso per l'invocazione.
Ritorni | |
---|---|
String |
getLabPreparersToRun
protectedgetLabPreparersToRun (IConfiguration config, String deviceName)
Recupera un elenco di preparatori di lab da eseguire su questo dispositivo.
Sostituito nei classi sandbox per impedire l'esecuzione dei preparativi dei lab all'interno della sandbox figlia
Parametri | |
---|---|
config |
IConfiguration |
deviceName |
String |
Ritorni | |
---|---|
|
getTargetPreparersToRun
protectedgetTargetPreparersToRun (IConfiguration config, String deviceName)
Recupera un elenco di preparatori target da eseguire su questo dispositivo.
Sostituito nei classi sandbox per impedire l'esecuzione dei preparativi dei lab all'interno della sandbox figlia
Parametri | |
---|---|
config |
IConfiguration |
deviceName |
String |
Ritorni | |
---|---|
|
linkExternalDirs
protected void linkExternalDirs (IBuildInfo info, TestInformation testInfo)
Parametri | |
---|---|
info |
IBuildInfo |
testInfo |
TestInformation |
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 |
|
Ritorni | |
---|---|
Throwable |
setTestTag
protected void setTestTag (IBuildInfo info, IConfiguration config)
Gestisci l'impostazione del tag di test nelle informazioni sulla compilazione.
Parametri | |
---|---|
info |
IBuildInfo |
config |
IConfiguration |