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.

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

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