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.

ParentSandboxInvocationExecution

public class ParentSandboxInvocationExecution
extends InvocationExecution

java.lang.Object
↳	com.android.tradefed.invoker.InvocationExecution
	↳	com.android.tradefed.invoker.sandbox.ParentSandboxInvocationExecution

Versão de InvocationExecution para as ações especiais de invocação principal ao executar uma sandbox.

Resumo

Construtores públicos
`ParentSandboxInvocationExecution()`

Métodos públicos
`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 do target_preparer e do multi_target_preparer.
`void`	`doTeardown(TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` Execute a etapa de encerramento do target_preparer e do 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 logger, TestInvocation.Stage stage)` Informar alguns registros de dispositivos em diferentes estágios da invocação.
`void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` Invoque o `ITestDevice.postInvocationTearDown(Throwable)` para cada parte do dispositivo da invocação.
`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.
`void`	`runTests(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Executa o teste.

Métodos protegidos
`IConfigurationFactory`	`getFactory()` Retorna o `IConfigurationFactory` usado para criar configurações.
`List<ITargetPreparer>`	`getLabPreparersToRun(IConfiguration config, String deviceName)` Recupere uma lista de preparadores de laboratório para executar neste dispositivo.
`IRunUtil`	`getRunUtil()`
`List<ITargetPreparer>`	`getTargetPreparersToRun(IConfiguration config, String deviceName)` Recupere uma lista de preparadores de destino para executar neste dispositivo.
`boolean`	`prepareAndRunSandbox(TestInformation info, IConfiguration config, ITestInvocationListener listener)` Retorna o status do resultado da execução da sandbox.

Construtores públicos

ParentSandboxInvocationExecution

public ParentSandboxInvocationExecution ()

Métodos públicos

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 listener)

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.
`listener`	`ITestLogger`: o `ITestLogger` para informar registros de falhas de configuração.

Gera
`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
`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
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

public 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
`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`

Métodos protegidos

getFactory

protected IConfigurationFactory getFactory ()

Retorna o IConfigurationFactory usado para criar configurações.

Retorna
`IConfigurationFactory`

getLabPreparersToRun

protected List<ITargetPreparer> getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Recupere uma lista de preparadores de laboratório para executar neste dispositivo.

Substituído em classes de sandbox para impedir que os preparadores de laboratório sejam executados no filho do sandbox.

Parâmetros
`config`	`IConfiguration`
`deviceName`	`String`

Retorna
`List<ITargetPreparer>`

getRunUtil

protected IRunUtil getRunUtil ()

Retorna
`IRunUtil`

getTargetPreparersToRun

protected List<ITargetPreparer> getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Recupere uma lista de preparadores de destino para executar neste dispositivo.

Substituído em classes de sandbox para impedir que os preparadores de laboratório sejam executados no filho do sandbox.

Parâmetros
`config`	`IConfiguration`
`deviceName`	`String`

Retorna
`List<ITargetPreparer>`

prepareAndRunSandbox

protected boolean prepareAndRunSandbox (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

Retorna o status do resultado da execução da sandbox.

Parâmetros
`info`	`TestInformation`
`config`	`IConfiguration`
`listener`	`ITestInvocationListener`

Retorna
`boolean`

Gera
`Throwable`