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 build, target_prep, esecuzione 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 i passaggi di pulizia target_preparer e multi_target_preparer. |
void
|
doSetup(TestInformation testInfo, IConfiguration config, ITestLogger listener)
Esegui i passaggi di configurazione target_preparer e multi_target_preparer. |
void
|
doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)
Esegui i passaggi di eliminazione target_preparer e multi_target_preparer. |
boolean
|
fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)
Esegui il passaggio build_provider della chiamata. |
void
|
reportLogs(ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)
Segnala alcuni log del dispositivo in una diversa fase della chiamata. |
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)
Tenta di eseguire lo sharding della configurazione in sottoconfigurazioni, per riprogrammarla per l'esecuzione più risorse in parallelo. |
Metodi protetti | |
---|---|
void
|
collectAutoInfo(IConfiguration config, TestInformation info)
Raccogli automaticamente alcune informazioni sul dispositivo principale sottoposto a test. |
IShardHelper
|
createShardHelper()
Crea una restituzione di |
void
|
customizeDevicePreInvocation(IConfiguration config, IInvocationContext context)
Dai la possibilità di personalizzare alcuni dispositivi prima di preInvocationSetup. |
String
|
getAdbVersion()
Restituisce la versione adb in uso per la chiamata. |
|
getLabPreparersToRun(IConfiguration config, String deviceName)
Recupera un elenco di preparativi del lab da eseguire su questo dispositivo. |
|
getTargetPreparersToRun(IConfiguration config, String deviceName)
Recupera un elenco di preparativi del 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)
Gestire l'impostazione del tag di test sulle informazioni sulla build. |
Campi
CHIAVE_VERSIONE_DB
public static final String ADB_VERSION_KEY
CHIAVE_CLASSPATH_JAVA_CLASSPATH
public static final String JAVA_CLASSPATH_KEY
CHIAVE_VERSIONE_JAVA
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 : IConfiguration di questa esecuzione di test. |
DoCleanUp
public void doCleanUp (IInvocationContext context, IConfiguration config, Throwable exception)
Esegui i passaggi di pulizia target_preparer e multi_target_preparer. I dispositivi puliscono verso l'alto.
Parametri | |
---|---|
context |
IInvocationContext : il IInvocationContext della chiamata. |
config |
IConfiguration : IConfiguration di questa esecuzione di test. |
exception |
Throwable : l'eccezione originale generata dal test in esecuzione. |
Configurazione dell'account
public void doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Esegui i passaggi di configurazione target_preparer e multi_target_preparer. Tutti i dispositivi vengono configurati richiesta per l'esecuzione del test.
Parametri | |
---|---|
testInfo |
TestInformation : il TestInformation della chiamata. |
config |
IConfiguration : IConfiguration di questa esecuzione di test. |
listener |
ITestLogger : i ITestLogger per segnalare i log degli errori di configurazione. |
Lanci | |
---|---|
BuildError |
|
DeviceNotAvailableException |
|
TargetSetupError |
DoTeardown
public void doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)
Esegui i passaggi di eliminazione target_preparer e multi_target_preparer. I dispositivi si strappano associati alla configurazione.
Parametri | |
---|---|
testInfo |
TestInformation : il TestInformation della chiamata. |
config |
IConfiguration : 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 della chiamata.
Parametri | |
---|---|
testInfo |
TestInformation : il TestInformation della chiamata. |
config |
IConfiguration : IConfiguration di questa esecuzione di test. |
rescheduler |
IRescheduler : il IRescheduler , per ripianificare parti della chiamata per
su altre risorse |
listener |
ITestInvocationListener : il ITestInvocation per segnalare gli errori di download della build. |
Ritorni | |
---|---|
boolean |
True se il download della build è andato a buon fine, false in caso contrario. |
Lanci | |
---|---|
BuildRetrievalError |
|
DeviceNotAvailableException |
reportLog
public void reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)
Segnala alcuni log del dispositivo in una diversa fase 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 della chiamata in cui ci troviamo. |
runDevicePostInvocationTeardown
public void runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception)
Richiama ITestDevice#postInvocationTearDown(Throwable)
per ogni parte del dispositivo
invocazione.
Parametri | |
---|---|
context |
IInvocationContext : il IInvocationContext della chiamata. |
config |
IConfiguration : IConfiguration di questa esecuzione di test. |
exception |
Throwable : l'eccezione originale generata dal test in esecuzione, se presente. |
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
invocazione.
Parametri | |
---|---|
context |
IInvocationContext : il IInvocationContext della chiamata. |
config |
IConfiguration : IConfiguration di questa esecuzione di test. |
logger |
ITestLogger : ITestLogger per segnalare i log. |
Lanci | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
runTest
public void runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)
Esegue il test.
Parametri | |
---|---|
info |
TestInformation : il valore TestInformation con cui eseguire i test. |
config |
IConfiguration : IConfiguration da eseguire |
listener |
ITestInvocationListener : ITestInvocationListener dei risultati del test |
shardConfig
public boolean shardConfig (IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
Tenta di eseguire lo sharding della configurazione in sottoconfigurazioni, per riprogrammarla per l'esecuzione più risorse in parallelo.
Se il numero di shard è maggiore di 1, creerà semplicemente le configurazioni per ogni shard
impostare gli indici di shard e riprogrammarli. Se non viene impostato un numero di shard,viene usato come riserva
IShardHelper#shardConfig
.
Parametri | |
---|---|
config |
IConfiguration : il valore attuale di IConfiguration . |
testInfo |
TestInformation : il TestInformation che contiene le informazioni sui test. |
rescheduler |
IRescheduler : IRescheduler . |
logger |
ITestLogger : ITestLogger utilizzato per registrare il file durante lo sharding. |
Ritorni | |
---|---|
boolean |
true se il test è stato eseguito con sharding. In caso contrario, restituisci false |
Metodi protetti
raccogliInfoAuto
protected void collectAutoInfo (IConfiguration config, TestInformation info)
Raccogli automaticamente alcune informazioni sul dispositivo principale sottoposto a test.
Parametri | |
---|---|
config |
IConfiguration |
info |
TestInformation |
Lanci | |
---|---|
DeviceNotAvailableException |
createShardHelper
protected IShardHelper createShardHelper ()
Crea una restituzione di IShardHelper
da utilizzare.
Ritorni | |
---|---|
IShardHelper |
personalizzazione della prechiamata del dispositivo
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
Dai la possibilità di personalizzare alcuni dispositivi prima di preInvocationSetup.
Parametri | |
---|---|
config |
IConfiguration : la configurazione della chiamata. |
context |
IInvocationContext : contesto di chiamata attuale. |
getAdbVersion
protected String getAdbVersion ()
Restituisce la versione adb in uso per la chiamata.
Ritorni | |
---|---|
String |
getLabPreparersToRun
protectedgetLabPreparersToRun (IConfiguration config, String deviceName)
Recupera un elenco di preparativi del lab da eseguire su questo dispositivo.
Sostituiti nelle classi sandbox per impedire ai preparativi del lab di essere eseguiti all'interno della sandbox figlio/a
Parametri | |
---|---|
config |
IConfiguration |
deviceName |
String |
Ritorni | |
---|---|
|
getTargetPreparersToRun
protectedgetTargetPreparersToRun (IConfiguration config, String deviceName)
Recupera un elenco di preparativi del target da eseguire su questo dispositivo.
Sostituiti nelle classi sandbox per impedire ai preparativi del lab di essere eseguiti all'interno della sandbox figlio/a
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 |
esecuzionePreparazioneRischiodi
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)
Gestire l'impostazione del tag di test sulle informazioni sulla build.
Parametri | |
---|---|
info |
IBuildInfo |
config |
IConfiguration |