A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco 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, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

java.lang.Object
↳	com.android.tradefed.sandbox.TradefedSandbox

Contêiner de sandbox que pode executar uma invocação do Trade Federation. TODO: Allow Options to be passed to the sandbox.

Resumo

Constantes
`String`	`EXTRA_TARGET_LAB`
`String`	`GENERAL_TESTS_ZIP`
`String`	`SANDBOX_ENABLED`

Construtores públicos
`TradefedSandbox()`

Métodos públicos
`String`	`createClasspath(File workingDir)` Crie um classpath com base no ambiente e no diretório de trabalho retornados por `ISandbox.getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])`.
`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 o 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.
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`static`	`matchSandboxExtraBuildTargetByConfigName(String configName)` Dado o nome da configuração de teste, corresponda aos destinos de build extras da caixa de areia.
`Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Prepare o ambiente para que a sandbox seja executada corretamente.
`CommandResult`	`run(TestInformation info, IConfiguration config, ITestLogger logger)` Execute o sandbox com o ambiente definido.
`void`	`tearDown()` Limpe todos os estados, arquivos ou ambientes que possam ter sido alterados.

Métodos protegidos
`File`	`dumpGlobalConfig(IConfiguration config, exclusionPatterns)` Despeja a configuração global filtrada de alguns objetos.
`String`	`getJava()`
`Exception`	`prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Prepare o `IConfiguration` que será transmitido ao subprocesso e vai direcionar a execução do contêiner.
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` Prepare e serializa o `IInvocationContext`.

Constantes

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

Valor da constante: "lab"

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

Valor da constante: "general-tests.zip"

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

Valor da constante: "SANDBOX_ENABLED"

Construtores públicos

TradefedSandbox

public TradefedSandbox ()

Métodos públicos

createClasspath

public String createClasspath (File workingDir)

Crie um classpath com base no ambiente e no diretório de trabalho retornados por ISandbox.getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.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 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 o 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.

getTradefedSandboxEnvironment

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

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

Retorna
`File`

matchSandboxExtraBuildTargetByConfigName

public static  matchSandboxExtraBuildTargetByConfigName (String configName)

Dado o nome da configuração de teste, corresponda aos destinos de build extras da caixa de areia.

Parâmetros
`configName`	`String`

Retorna

prepareEnvironment

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Prepare o ambiente para que a sandbox seja executada corretamente.

Parâmetros
`context`	`IInvocationContext`: o `IInvocationContext` da invocação atual.
`config`	`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 CommandResult run (TestInformation info, 
                IConfiguration config, 
                ITestLogger logger)

Execute o sandbox com o ambiente definido.

Parâmetros
`info`	`TestInformation`: o `TestInformation` que descreve a invocação
`config`	`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.

tearDown

public void tearDown ()

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

Métodos protegidos

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

Despeja a configuração global filtrada de alguns objetos.

Parâmetros
`config`	`IConfiguration`
`exclusionPatterns`

Retorna
`File`

Gera
`ConfigurationException`

getJava

protected String getJava ()

Retorna
`String`

prepareConfiguration

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Prepare o IConfiguration que será transmitido ao subprocesso e vai direcionar a execução do contêiner.

Parâmetros
`context`	`IInvocationContext`: o `IInvocationContext` atual.
`config`	`IConfiguration`: o `IConfiguration` a ser preparado.
`listener`	`ITestInvocationListener`: o `ITestInvocationListener` da invocação atual.

Retorna
`Exception`	Uma exceção se algo der errado. Caso contrário, é nulo.

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Prepare e serializa o IInvocationContext.

Parâmetros
`context`	`IInvocationContext`: o `IInvocationContext` a ser preparado.
`config`	`IConfiguration`: o `IConfiguration` do sandbox.

Retorna
`File`	o `IInvocationContext` serializado.

Gera
	IOException