InvocaçãoExecução
public class InvocationExecution
extends Object
implements IInvocationExecution
java.lang.Object | |
↳ | com.android.tradefed.invoker.InvocationExecution |
Classe que descreve todas as etapas de invocação: build download, target_prep, executar testes, limpar. Pode ser estendido para substituir o comportamento padrão de algumas etapas. A ordem das etapas é controlada por TestInvocation
.
Resumo
Campos | |
---|---|
public static final String | ADB_VERSION_KEY |
public static final String | JAVA_CLASSPATH_KEY |
public static final String | JAVA_VERSION_KEY
|
Construtores públicos | |
---|---|
InvocationExecution () |
Métodos públicos | |
---|---|
void | cleanUpBuilds ( IInvocationContext context, IConfiguration config) Execute a etapa de limpeza build_provider. |
void | doCleanUp ( IInvocationContext context, IConfiguration config, Throwable exception) Execute a etapa de limpeza target_preparer e multi_target_preparer. |
void | doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener) Execute a etapa de configuração target_preparer e multi_target_preparer. |
void | doTeardown ( TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) Execute a etapa de desmontagem target_preparer e multi_target_preparer. |
boolean | fetchBuild ( TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener) Execute a etapa build_provider da invocação. |
void | reportLogs ( ITestDevice device, ITestLogger listener, TestInvocation.Stage stage) Relate alguns logs do dispositivo em diferentes estágios da invocação. |
void | runDevicePostInvocationTearDown ( IInvocationContext context, IConfiguration config, Throwable exception) Invoque o |
void | runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger) Invoque o |
void | runTests ( TestInformation info, IConfiguration config, ITestInvocationListener listener) Executa o teste. |
boolean | shardConfig ( IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger) Tente fragmentar a configuração em subconfigurações, para serem reagendadas para execução em vários recursos em paralelo. |
Métodos protegidos | |
---|---|
void | collectAutoInfo ( IConfiguration config, TestInformation info) Colete automaticamente algumas informações sobre o dispositivo principal em teste. |
IShardHelper | createShardHelper () Crie um retorno do |
void | customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context) Dê a chance de customizar parte do dispositivo antes do preInvocationSetup. |
String | getAdbVersion () Retorna a versão do adb em uso para a invocação. |
getLabPreparersToRun ( IConfiguration config, String deviceName) Recupere uma lista de preparadores de laboratório para executar neste dispositivo. | |
getTargetPreparersToRun ( IConfiguration config, String deviceName) Recupere uma lista de preparadores de destino para executar neste dispositivo. | |
void | logHostAdb ( IConfiguration config, ITestLogger logger) Colete os logs de $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) Lide com a configuração da tag de teste nas informações de compilação. |
Campos
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
Construtores públicos
InvocaçãoExecução
public InvocationExecution ()
Métodos públicos
cleanUpBuilds
public void cleanUpBuilds (IInvocationContext context, IConfiguration config)
Execute a etapa de limpeza build_provider. Associado à busca de build.
Parâmetros | |
---|---|
context | IInvocationContext : o IInvocationContext da invocação. |
config | IConfiguration : a IConfiguration desta execução de teste. |
doCleanUp
public void doCleanUp (IInvocationContext context, IConfiguration config, Throwable exception)
Execute a etapa de limpeza target_preparer e multi_target_preparer. Os dispositivos limpam.
Parâmetros | |
---|---|
context | IInvocationContext : o IInvocationContext da invocação. |
config | IConfiguration : a IConfiguration desta execução de teste. |
exception | Throwable : a exceção original lançada pela execução do teste. |
doSetup
public void doSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Execute a etapa de configuração target_preparer e multi_target_preparer. Faz todas as configurações de dispositivos necessárias para a execução do teste.
Parâmetros | |
---|---|
testInfo | TestInformation : o TestInformation da invocação. |
config | IConfiguration : a IConfiguration desta execução de teste. |
listener | ITestLogger : o ITestLogger para relatar logs de falhas de configuração. |
lances | |
---|---|
BuildError | |
DeviceNotAvailableException | |
TargetSetupError |
doTeardown
public void doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)
Execute a etapa de desmontagem target_preparer e multi_target_preparer. Os dispositivos desmontam associados à configuração.
Parâmetros | |
---|---|
testInfo | TestInformation : o TestInformation da invocação. |
config | IConfiguration : a IConfiguration desta execução de teste. |
logger | ITestLogger : o ITestLogger para relatar logs. |
exception | Throwable : a exceção original lançada pela execução do teste. |
buscarBuild
public boolean fetchBuild (TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)
Execute a etapa build_provider da invocação.
Parâmetros | |
---|---|
testInfo | TestInformation : o TestInformation da invocação. |
config | IConfiguration : a IConfiguration desta execução de teste. |
rescheduler | IRescheduler : o IRescheduler , para reagendar partes da invocação para execução em outro(s) recurso(s) |
listener | ITestInvocationListener : o ITestInvocation para relatar falhas de download de compilação. |
devoluções | |
---|---|
boolean | Verdadeiro se baixamos a compilação com sucesso, caso contrário, falso. |
lances | |
---|---|
BuildRetrievalError | |
DeviceNotAvailableException |
reportLogs
public void reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)
Relate alguns logs do dispositivo em diferentes estágios da invocação. Por exemplo: logcat.
Parâmetros | |
---|---|
device | ITestDevice : O dispositivo do qual relatar logs. |
listener | ITestLogger : O logger para os logs. |
stage | TestInvocation.Stage : O estágio da invocação em que estamos. |
runDevicePostInvocationTearDown
public void runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception)
Invoque o ITestDevice#postInvocationTearDown(Throwable)
para cada parte do dispositivo da invocação.
Parâmetros | |
---|---|
context | IInvocationContext : o IInvocationContext da invocação. |
config | IConfiguration : a IConfiguration desta execução de teste. |
exception | Throwable : a exceção original lançada pelo teste em execução, se houver. |
runDevicePreInvocationSetup
public void runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger)
Invoque o ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo))
para cada parte do dispositivo da invocação.
Parâmetros | |
---|---|
context | IInvocationContext : o IInvocationContext da invocação. |
config | IConfiguration : a IConfiguration desta execução de teste. |
logger | ITestLogger : o ITestLogger para relatar logs. |
lances | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
runTests
public void runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)
Executa o teste.
Parâmetros | |
---|---|
info | TestInformation : o TestInformation com o qual executar testes. |
config | IConfiguration : o IConfiguration a ser executado |
listener | ITestInvocationListener : o ITestInvocationListener dos resultados do teste |
shardConfig
public boolean shardConfig (IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
Tente fragmentar a configuração em subconfigurações, para serem reagendadas para execução em vários recursos em paralelo.
Se uma contagem de estilhaços for maior que 1, ela simplesmente criará configurações para cada estilhaço definindo índices de estilhaços e reagendando-os. Se uma contagem de fragmentos não for definida, ela retornará para IShardHelper#shardConfig
.
Parâmetros | |
---|---|
config | IConfiguration : o IConfiguration atual. |
testInfo | TestInformation : o TestInformation contendo as informações dos testes. |
rescheduler | IRescheduler : o IRescheduler . |
logger | ITestLogger : ITestLogger usado para registrar o arquivo durante a fragmentação. |
devoluções | |
---|---|
boolean | true se o teste foi fragmentado. Caso contrário, retorne false |
Métodos protegidos
coletarAutoInfo
protected void collectAutoInfo (IConfiguration config, TestInformation info)
Colete automaticamente algumas informações sobre o dispositivo principal em teste.
Parâmetros | |
---|---|
config | IConfiguration |
info | TestInformation |
lances | |
---|---|
DeviceNotAvailableException |
createShardHelper
protected IShardHelper createShardHelper ()
Crie um retorno do IShardHelper
a ser usado.
devoluções | |
---|---|
IShardHelper |
customizeDevicePreInvocation
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
Dê a chance de customizar parte do dispositivo antes do preInvocationSetup.
Parâmetros | |
---|---|
config | IConfiguration : a configuração da invocação. |
context | IInvocationContext : O contexto de invocação atual. |
getAdbVersion
protected String getAdbVersion ()
Retorna a versão do adb em uso para a invocação.
devoluções | |
---|---|
String |
getLabPreparersToRun
protectedgetLabPreparersToRun (IConfiguration config, String deviceName)
Recupere uma lista de preparadores de laboratório para executar neste dispositivo.
Substituído em classes sandbox para impedir que os preparadores de laboratório sejam executados dentro do filho sandbox
Parâmetros | |
---|---|
config | IConfiguration |
deviceName | String |
devoluções | |
---|---|
getTargetPreparersToRun
protectedgetTargetPreparersToRun (IConfiguration config, String deviceName)
Recupere uma lista de preparadores de destino para executar neste dispositivo.
Substituído em classes sandbox para impedir que os preparadores de laboratório sejam executados dentro do filho sandbox
Parâmetros | |
---|---|
config | IConfiguration |
deviceName | String |
devoluções | |
---|---|
logHostAdb
protected void logHostAdb (IConfiguration config, ITestLogger logger)
Colete os logs de $TMPDIR/adb.$UID.log.
Parâmetros | |
---|---|
config | IConfiguration |
logger | ITestLogger |
runPreparersTearDown
protected Throwable runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception,preparersToRun, trackPreparersMap)
Parâmetros | |
---|---|
testInfo | TestInformation |
device | ITestDevice |
deviceName | String |
deviceIndex | int |
logger | ITestLogger |
exception | Throwable |
preparersToRun | |
trackPreparersMap |
devoluções | |
---|---|
Throwable |
setTestTag
protected void setTestTag (IBuildInfo info, IConfiguration config)
Lide com a configuração da tag de teste nas informações de compilação.
Parâmetros | |
---|---|
info | IBuildInfo |
config | IConfiguration |