Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

Subclasses indiretas conhecidas

DelegatedInvocationExecution, InvocationExecution, ParentSandboxInvocationExecution, RemoteInvocationExecution, SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution`, que delega 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 uma sandbox.
RemoteInvocationExecution	Implementação de `InvocationExecution` que impulsiona uma execução remota.
SandboxedInvocationExecution	Execução especial de sandbox da invocação: é o InvocationExection 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 target_preparer e multi_target_preparer.
`default void`	`doSetup(TestInformation testInfo, IConfiguration config, ITestLogger logger)` Execute a etapa de configuração do target_preparer e do multi_target_preparer.
`default void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Execute a etapa de encerramento do target_preparer e do 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 de dispositivos 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 fragmentar a configuração em subconfigurações para serem reagendadas e executadas 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 do 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. Faz a limpeza dos dispositivos.

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 do target_preparer e do multi_target_preparer. Faz toda a configuração dos dispositivos necessária 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 informar registros de falhas de configuração.

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

doTeardown

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

Execute a etapa de encerramento do target_preparer e do multi_target_preparer. Desmonta os dispositivos 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 informar registros.
`exception`	`Throwable`: a exceção original gerada pela execução do teste.

Gera
	java.lang.Throwable
`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 reagendar partes da invocação para execução em outros recursos.
`listener`	`ITestInvocationListener`: o `ITestInvocation` para informar falhas no download do build.

Retorna
`boolean`	True se o download do build for concluído. Caso contrário, false.

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 de dispositivos em diferentes estágios da invocação. Por exemplo: logcat.

Parâmetros
`device`	`ITestDevice`: o dispositivo de onde os registros serão informados.
`logger`	`ITestLogger`: o registrador 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 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 informar 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
	java.lang.Throwable
`Throwable`

shardConfig

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

Tente fragmentar a configuração em subconfigurações para serem reagendadas e executadas em vários recursos em paralelo.

Se uma contagem de fragmentos for maior que 1, ela simplesmente criará configurações para cada fragmento definindo índices de fragmentos e reagendando-os. Se uma contagem de fragmentos não for definida,ela vai voltar 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 o fragmentação.

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