Execução de Invocaçã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, execução de testes, limpeza. Pode ser estendido para substituir o comportamento padrão de algumas etapas. A ordem das etapas é determinada 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 de dispositivos 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 reprogramadas para serem executadas 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 personalizar alguns dispositivos 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 execução neste dispositivo. | |
getTargetPreparersToRun ( IConfiguration config, String deviceName) Recupere uma lista de preparadores de destino para execução 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
Execução de Invocação
public InvocationExecution ()
Métodos públicos
limparConstruções
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 : o 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 são limpos.
Parâmetros | |
---|---|
context | IInvocationContext : o IInvocationContext da invocação. |
config | IConfiguration : o 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 : o IConfiguration desta execução de teste. |
listener | ITestLogger : o ITestLogger para relatar logs de falhas de configuração. |
Lança | |
---|---|
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 são desmontados associados à configuração.
Parâmetros | |
---|---|
testInfo | TestInformation : o TestInformation da invocação. |
config | IConfiguration : o 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 : o IConfiguration desta execução de teste. |
rescheduler | IRescheduler : o IRescheduler , para reprogramar partes da invocação para execução em outro(s) recurso(s) |
listener | ITestInvocationListener : o ITestInvocation para relatar falhas de download de build. |
Devoluções | |
---|---|
boolean | Verdadeiro se baixamos a compilação com sucesso; caso contrário, falso. |
Lança | |
---|---|
BuildRetrievalError | |
DeviceNotAvailableException |
relatórioLogs
public void reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)
Relate alguns logs de dispositivos em diferentes estágios da invocação. Por exemplo: logcat.
Parâmetros | |
---|---|
device | ITestDevice : o dispositivo do qual relatar logs. |
listener | ITestLogger : o criador de logs dos 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 : o 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 : o IConfiguration desta execução de teste. |
logger | ITestLogger : o ITestLogger para relatar logs. |
Lança | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
executar testes
public void runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)
Executa o teste.
Parâmetros | |
---|---|
info | TestInformation : o TestInformation para 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 reprogramadas para serem executadas em vários recursos em paralelo.
Se a contagem de fragmentos for maior que 1, ele simplesmente criará configurações para cada fragmento, definindo índices de fragmentos e reprogramando-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 que contém 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 |
Lança | |
---|---|
DeviceNotAvailableException |
criarShardHelper
protected IShardHelper createShardHelper ()
Crie um retorno do IShardHelper
a ser usado.
Devoluções | |
---|---|
IShardHelper |
personalizarDevicePreInvocation
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
Dê a chance de personalizar alguns dispositivos 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 execução neste dispositivo.
Substituído nas classes sandbox para impedir que os preparadores de laboratório sejam executados dentro do sandbox filho
Parâmetros | |
---|---|
config | IConfiguration |
deviceName | String |
Devoluções | |
---|---|
getTargetPreparersToRun
protectedgetTargetPreparersToRun (IConfiguration config, String deviceName)
Recupere uma lista de preparadores de destino para execução neste dispositivo.
Substituído nas classes sandbox para impedir que os preparadores de laboratório sejam executados dentro do sandbox filho
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 |
definirTestTag
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 |