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.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Subclasses indiretas conhecidas

GoogleTradefedSandbox, TradefedSandbox

GoogleTradefedSandbox	Especialização interna de `TradefedSandbox` a ser usada na infraestrutura do laboratório.
TradefedSandbox	Contêiner de sandbox que pode executar uma invocação do Trade Federation.

Interface que define um sandbox que pode ser usado para executar uma invocação.

Resumo

Métodos públicos
`abstract String`	`createClasspath(File workingDir)` Crie um classpath com base no ambiente e no diretório de trabalho retornados por `getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[])`.
`abstract IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` Modo especial desconectado da execução principal: quando uma configuração não parece existir no pai, fazemos fallback para o inicializador simples, em que tentamos configurar a sandbox com informações conhecidas e preencher o diretório de trabalho para criar a configuração totalmente no diretório versionado.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Uma subetapa de `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` que descobre testes se `SandboxOptions.shouldUseTestDiscovery()` está ativado.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` Subetapa de `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` que busca arquivos extras necessários para o sandbox.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Retorna o ambiente de sandbox do TF a ser usado com base nos argumentos da linha de comando.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`abstract Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)` Prepare o ambiente para que a sandbox seja executada corretamente.
`abstract CommandResult`	`run(TestInformation info, IConfiguration configuration, ITestLogger logger)` Execute o sandbox com o ambiente definido.
`abstract void`	`tearDown()` Limpe todos os estados, arquivos ou ambientes que possam ter sido alterados.

Métodos públicos

createClasspath

public abstract String createClasspath (File workingDir)

Crie um classpath com base no ambiente e no diretório de trabalho retornados por getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]).

Parâmetros
`workingDir`	`File`: o diretório de trabalho atual do sandbox.

Retorna
`String`	O classpath a ser usado.

Gera
`ConfigurationException`

createThinLauncherConfig

public abstract IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

Modo especial desconectado da execução principal: quando uma configuração não parece existir no pai, fazemos fallback para o inicializador simples, em que tentamos configurar a sandbox com informações conhecidas e preencher o diretório de trabalho para criar a configuração totalmente no diretório com versão.

Parâmetros
`args`	`String`: os argumentos originais da linha de comando.
`keyStoreClient`	`IKeyStoreClient`: o cliente de keystore atual a ser usado para criar configurações.
`runUtil`	`IRunUtil`: o `IRunUtil` atual para executar comandos do host.
`globalConfig`	`File`: a configuração global a ser usada para executar subprocessos do TF.

Retorna
`IConfiguration`	Um arquivo que aponta para o XML de configuração do TF para objetos NON_VERSIONED. Retorna nulo se não for possível criar uma configuração de inicializador simples.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Uma subetapa de prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) que descobre testes se SandboxOptions.shouldUseTestDiscovery() está ativado.

Parâmetros
`context`	`IInvocationContext`: o `IInvocationContext` da invocação atual.
`configuration`	`IConfiguration`: o `IConfiguration` do comando a ser executado.

Retorna
`Map<String, List<String>>`	O mapa de testes descobertos ou nulo se não for compatível ou falhar.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

Parâmetros
`context`	`IInvocationContext`
`configuration`	`IConfiguration`
`logger`	`ITestLogger`

Retorna
`Map<String, List<String>>`

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

Subetapa de prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) que busca arquivos extras necessários para o sandbox.

Parâmetros
`context`	`IInvocationContext`: o `IInvocationContext` da invocação atual.
`configuration`	`IConfiguration`: o `IConfiguration` do comando a ser executado.
`args`	`String`: os argumentos da linha de comando.

Retorna
`IFolderBuildInfo`	o build buscado para os arquivos adicionais em sandbox.

Gera
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	java.io.IOException
`BuildRetrievalError`
`ConfigurationException`
`IOException`

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

Retorna o ambiente de sandbox do TF a ser usado com base nos argumentos da linha de comando.

Parâmetros
`context`	`IInvocationContext`: o `IInvocationContext` do elemento pai.
`nonVersionedConfig`	`IConfiguration`: o `IConfiguration` que representa os objetos sem controle de versão.
`args`	`String`: os argumentos da linha de comando.

Retorna
`File`	um diretório `File` que contém os jars do ambiente de sandbox do TF.

Gera
`Exception`

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger, 
                String[] args)

Parâmetros
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

Retorna
`File`

Gera
`Exception`

prepareEnvironment

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

Prepare o ambiente para que a sandbox seja executada corretamente.

Parâmetros
`context`	`IInvocationContext`: o `IInvocationContext` da invocação atual.
`configuration`	`IConfiguration`: o `IConfiguration` do comando a ser executado.
`listener`	`ITestInvocationListener`: a invocação atual `ITestInvocationListener` em que os resultados finais devem ser transmitidos.

Retorna
`Exception`	um `Exception` que contém a falha ou "Null" se a operação for bem-sucedida.

run

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

Execute o sandbox com o ambiente definido.

Parâmetros
`info`	`TestInformation`: o `TestInformation` que descreve a invocação
`configuration`	`IConfiguration`: o `IConfiguration` do comando a ser executado.
`logger`	`ITestLogger`: um `ITestLogger` em que podemos registrar arquivos.

Retorna
`CommandResult`	um `CommandResult` com o status da execução e os registros do sandbox.

Gera
`Throwable`

tearDown

public abstract void tearDown ()

Limpe todos os estados, arquivos ou ambientes que possam ter sido alterados.