IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

Subclasses indiretas conhecidas DelegatedInvocationExecution, InvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution DelegatedInvocationExecution InvocationExecution que delegam a execução a outro binário do Tradefed.  InvocationExecution Classe que descreve todas as etapas de invocação: download do build, target_prep, execução de testes e limpeza.  ParentSandboxInvocationExecution Versão de InvocationExecution para as ações especiais de invocação principal ao executar um sandbox.  RemoteInvocationExecution Implementação de InvocationExecution que gera uma execução remota.  SandboxedInvocationExecution Execução especial de sandbox da invocação: é a InvocationExection para quando estamos dentro do sandbox executando o comando.

---

Interface que descreve as ações que serão realizadas como parte de uma invocação. A invocação 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 de target_preparer e multi_target_preparer.
default void	doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger) Execute a etapa de configuração de target_preparer e multi_target_preparer.
default void	doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception) Execute a etapa de desmontagem de 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) Informe 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 da 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 da 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) Tente dividir a configuração em subconfigurações para que ela seja reprogramada para ser executada em vários recursos em paralelo.

Métodos públicos

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Execute a etapa de limpeza do 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 de 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 gerada pela execução do teste.

doSetup

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

Execute a etapa de configuração de target_preparer e multi_target_preparer. Verifique se todos os dispositivos estão configurados corretamente para que o teste seja executado.

Parâmetros
testInfo	TestInformation: o TestInformation da invocação.
config	IConfiguration: o IConfiguration desta execução de teste.
logger	ITestLogger: o ITestLogger para informar 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 de target_preparer e multi_target_preparer. Os dispositivos são desativados 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 gerar registros.
exception	Throwable: a exceção original gerada pela execução do teste.

Gera
	Throwable

fetchBuild

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 recurso
listener	ITestInvocationListener: o ITestInvocation para informar falhas de download do build.

Retorna
boolean	Verdadeiro se o download do build foi bem-sucedido. Caso contrário, é 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)

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

Parâmetros
device	ITestDevice: o dispositivo para informar os registros.
logger	ITestLogger: o registrador dos registros.
stage	TestInvocation.Stage: a etapa 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 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 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 gerar 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 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)

Tente dividir a configuração em subconfigurações para que ela seja reprogramada para ser executada em vários recursos em paralelo.

Se a contagem de fragmentos for maior que 1, ele simplesmente vai criar configurações para cada fragmento, definindo índices de fragmento e reprogramando-os. Se a contagem de fragmentos não estiver definida,ela vai voltar para IShardHelper.shardConfig.

Parâmetros
config	IConfiguration: o IConfiguration atual.
testInfo	TestInformation: o TestInformation que armazena as informações dos testes.
rescheduler	IRescheduler: o IRescheduler.
logger	ITestLogger: ITestLogger usado para registrar o arquivo durante o sharding.

Retorna
boolean	Verdadeiro se o teste foi dividido em fragmentos. Caso contrário, retorne false.