IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution


Interface que descreve as ações que serão feitas como parte de uma invocação. A invocação O próprio TestInvocation garante a ordem das chamadas.

Resumo

Métodos públicos

default void cleanUpBuilds(IInvocationContext context, IConfiguration config)

Execute a etapa de limpeza do build_provider.

default void doCleanUp(IInvocationContext context, IConfiguration config, Throwable exception)

Execute a etapa de limpeza target_preparer e multi_target_preparer cleanUp.

default void doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger)

Execute a etapa de configuração "target_preparer" e "multi_target_preparer".

default void doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)

Execute a etapa de desmontagem target_preparer e multi_target_preparer.

default boolean fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)

Execute a etapa build_provider da invocação.

abstract void reportLogs(ITestDevice device, ITestLogger logger, TestInvocation.Stage stage)

Informar alguns registros do dispositivo em diferentes estágios da invocação.

default void runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)

Invoque o ITestDevice#postInvocationTearDown(Throwable) para cada parte do dispositivo do invocação.

default 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 do invocação.

default void runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)

Executa o teste.

default boolean shardConfig(IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)

Tentativa de fragmentar a configuração em subconfigurações, a serem reagendadas para execução vários recursos em paralelo.

Métodos públicos

Limpeza de builds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Execute a etapa de limpeza do build_provider. Associadas à 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 cleanUp. Os dispositivos são limpos? para cima.

Parâmetros
context IInvocationContext: o IInvocationContext da invocação.

config IConfiguration: o IConfiguration desta execução de teste.

exception Throwable: a exceção original gerada pela execução do teste.

Configuração

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger)

Execute a etapa de configuração "target_preparer" e "multi_target_preparer". Todos os dispositivos estão configurados? necessários para a execução do teste.

Parâmetros
testInfo TestInformation: o TestInformation da invocação.

config IConfiguration: o IConfiguration desta execução de teste.

logger ITestLogger: o ITestLogger para relatar os registros de falhas de configuração.

Gera
com.android.tradefed.targetprep.TargetSetupError
com.android.tradefed.targetprep.BuildError
com.android.tradefed.device.DeviceNotAvailableException
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 rompem 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 registros.

exception Throwable: a exceção original gerada pela execução do teste.

Gera
Throwable

GETBuild

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 de execução em outros recursos

listener ITestInvocationListener: o ITestInvocation para relatar falhas de download do build.

Retorna
boolean Verdadeiro se o download do build tiver sido concluído. Caso contrário, retorna falso.

Gera
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.device.DeviceNotAvailableException
BuildRetrievalError
DeviceNotAvailableException

reportLogs

public abstract void reportLogs (ITestDevice device, 
                ITestLogger logger, 
                TestInvocation.Stage stage)

Informar alguns registros do dispositivo em diferentes estágios da invocação. Por exemplo: Logcat.

Parâmetros
device ITestDevice: o dispositivo do qual os registros serão relatados.

logger ITestLogger: o logger dos registros.

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 do 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 gerada 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 do 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 registros.

Gera
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

runTests

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

Executa o teste.

Parâmetros
info TestInformation: o TestInformation usado para executar testes.

config IConfiguration: o IConfiguration a ser executado.

listener ITestInvocationListener: o ITestInvocationListener dos resultados do teste.

Gera
Throwable

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

Tentativa de fragmentar a configuração em subconfigurações, a serem reagendadas para execução vários recursos em paralelo.

Se uma contagem de fragmentos for maior que 1, ele simplesmente criará configurações para cada fragmento ao definindo índices de fragmento e reprogramando-os. Se uma contagem de fragmentos não estiver definida,ele usará 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.

Retorna
boolean verdadeiro se o teste foi fragmentado. Caso contrário, retorna false