InvocationExecution
public class InvocationExecution
extends Object
implements IInvocationExecution
java.lang.Object | |
↳ | com.android.tradefed.invoker.InvocationExecution |
Classe que descreve todas as etapas de invocação: download de compilação, target_prep, execução de testes, limpeza. Pode ser estendido para substituir o comportamento padrão de algumas etapas. Ordem das etapas é impulsionado 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
|
Construtoras públicas | |
---|---|
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 chamada. |
void | reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage) Relate alguns logs de dispositivo em diferentes estágios da invocação. |
void | runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception) Invocar o |
void | runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger) Chamar 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 ser reprogramado 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 () Criar um retorno a |
void | customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context) Dê a chance de personalizar alguns dos dispositivos antes de preInvocationSetup. |
String | getAdbVersion () Retorna a versão do adb em uso para a invocação. |
getPreparersToRun ( IConfiguration config, String deviceName) Recupere uma lista de preparadores para executar neste dispositivo. | |
void | logHostAdb ( IConfiguration config, ITestLogger logger) Colete os logs de $ TMPDIR / adb. $ UID.log. |
void | runPreparersSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener) |
Throwable | runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun) runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, preparersToRun) |
void | setTestTag (IBuildInfo info, IConfiguration config) Lidar 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
Construtoras públicas
InvocationExecution
public InvocationExecution ()
Métodos públicos
cleanUpBuilds
public void cleanUpBuilds (IInvocationContext context, IConfiguration config)
Execute a etapa de limpeza build_provider. Associado à busca de construção.
Parâmetros | |
---|---|
context | IInvocationContext : o IInvocationContext da invocação. |
config | IConfiguration : o IConfiguration deste 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 : o IConfiguration deste teste. |
exception | Throwable : a exceção original lançada pelo teste de corrida. |
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 que o teste seja executado.
Parâmetros | |
---|---|
testInfo | TestInformation : o TestInformation da invocação. |
config | IConfiguration : o IConfiguration deste teste. |
listener | ITestLogger : o ITestLogger para relatar falhas de instalação logs. |
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 desmontam associados à configuração.
Parâmetros | |
---|---|
testInfo | TestInformation : o TestInformation da invocação. |
config | IConfiguration : o IConfiguration deste teste. |
logger | ITestLogger : o ITestLogger denunciar logs. |
exception | Throwable : a exceção original lançada pelo teste de corrida. |
fetchBuild
public boolean fetchBuild (TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)
Execute a etapa build_provider da chamada.
Parâmetros | |
---|---|
testInfo | TestInformation : o TestInformation da invocação. |
config | IConfiguration : o IConfiguration deste teste. |
rescheduler | IRescheduler : o IRescheduler , para o reescalonamento porções da chamada para execução em um outro recurso (s) |
listener | ITestInvocationListener : o ITestInvocation ao relatório de compilação de download falhas. |
Devoluções | |
---|---|
boolean | Verdadeiro se baixamos a compilação com sucesso, caso contrário, falso. |
Lança | |
---|---|
BuildRetrievalError | |
DeviceNotAvailableException |
reportLogs
public void reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)
Relate alguns logs de dispositivo em diferentes estágios da invocação. Por exemplo: logcat.
Parâmetros | |
---|---|
device | ITestDevice : O dispositivo para relatar registros de. |
listener | ITestLogger : O logger para os logs. |
stage | TestInvocation.Stage : O estágio da invocação estamos. |
runDevicePostInvocationTearDown
public void runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception)
Invocar 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 deste teste. |
exception | Throwable : a exceção original lançada pelo teste de corrida, se houver. |
runDevicePreInvocationSetup
public void runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger)
Chamar 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 deste teste. |
logger | ITestLogger : o ITestLogger denunciar logs. |
Lança | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
runTests
public void runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)
Executa o teste.
Parâmetros | |
---|---|
info | TestInformation : o TestInformation para executar testes com. |
config | IConfiguration : o IConfiguration a prazo |
listener | ITestInvocationListener : o ITestInvocationListener dos resultados dos testes |
shardConfig
public boolean shardConfig (IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)
Tente fragmentar a configuração em subconfigurações, para ser reprogramado para execução em vários recursos em paralelo.
Se uma contagem de shard for maior que 1, ele simplesmente criará configurações para cada shard definindo índices de shard e reprogramando-os. Se uma contagem caco não está definido, seria fallback para IShardHelper#shardConfig
.
Parâmetros | |
---|---|
config | IConfiguration : a corrente IConfiguration . |
testInfo | TestInformation : o TestInformation segurando a informação dos testes. |
rescheduler | IRescheduler : o IRescheduler . |
logger | ITestLogger : ITestLogger usado para arquivo de log durante a fragmentação. |
Devoluções | |
---|---|
boolean | verdadeiro se o teste foi fragmentado. Caso contrário retorno false |
Métodos protegidos
collectAutoInfo
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 |
createShardHelper
protected IShardHelper createShardHelper ()
Criar um retorno a IShardHelper
a ser utilizado.
Devoluções | |
---|---|
IShardHelper |
customizeDevicePreInvocation
protected void customizeDevicePreInvocation (IConfiguration config, IInvocationContext context)
Dê a chance de personalizar alguns dos dispositivos antes de preInvocationSetup.
Parâmetros | |
---|---|
config | IConfiguration : A configuração da invocação. |
context | IInvocationContext : O atual contexto de invocação. |
getAdbVersion
protected String getAdbVersion ()
Retorna a versão do adb em uso para a invocação.
Devoluções | |
---|---|
String |
getPreparersToRun
protectedgetPreparersToRun (IConfiguration config, String deviceName)
Recupere uma lista de preparadores para executar neste dispositivo.
Substituído em 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 |
runPreparersSetup
protected void runPreparersSetup (TestInformation testInfo, IConfiguration config, ITestLogger listener)
Parâmetros | |
---|---|
testInfo | TestInformation |
config | IConfiguration |
listener | ITestLogger |
Lança | |
---|---|
BuildError | |
DeviceNotAvailableException | |
TargetSetupError |
runPreparersTearDown
protected Throwable runPreparersTearDown (TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception,preparersToRun)
Parâmetros | |
---|---|
testInfo | TestInformation |
device | ITestDevice |
deviceName | String |
deviceIndex | int |
logger | ITestLogger |
exception | Throwable |
preparersToRun |
Devoluções | |
---|---|
Throwable |
setTestTag
protected void setTestTag (IBuildInfo info, IConfiguration config)
Lidar com a configuração da tag de teste nas informações de compilação.
Parâmetros | |
---|---|
info | IBuildInfo |
config | IConfiguration |