A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Subclasses indiretas conhecidas

TradefedSandbox (link em inglês)

TradefedSandbox (link em inglês) Contêiner de sandbox que pode executar uma invocação da 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 retornado por `getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.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, voltamos ao iniciador fino, em que tentamos configurar o sandbox com as informações conhecidas e preencher o diretório de trabalho para criar a configuração totalmente no diretório com versão.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Uma etapa secundária de `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` que descobre se `SandboxOptions.shouldUseTestDiscovery()` está ativado.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` Subetapa de `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` que busca outros arquivos necessários para o sandbox.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Retorna o TF do ambiente de sandbox 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 o sandbox seja executado 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 retornado por 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 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, voltamos ao iniciador fino, em que tentamos configurar o sandbox com as 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 nenhuma configuração de inicializador fino puder ser criada.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Uma etapa secundária de prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) que descobre se SandboxOptions.shouldUseTestDiscovery() está ativado.

Parâmetros
`context`	`IInvocationContext`: a invocação atual `IInvocationContext`.
`configuration`	`IConfiguration`: o `IConfiguration` para que o comando seja executado.

Retorna
	O mapa de testes descobertos ou nulo se não houver suporte ou se falhar.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

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

Retorna

fetchSandboxExtraArtifacts

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

Subetapa de prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) que busca outros arquivos necessários para o sandbox.

Parâmetros
`context`	`IInvocationContext`: a invocação atual `IInvocationContext`.
`configuration`	`IConfiguration`: o `IConfiguration` para que o comando seja 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
	IOException
`BuildRetrievalError`
`ConfigurationException`

getTradefedSandboxEnvironment

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

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

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

Retorna
`File`	um diretório `ERROR(/File)` que contém os frascos do ambiente de sandbox do TF.

getTradefedSandboxEnvironment

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

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

Retorna
`File`

prepareEnvironment

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

Prepare o ambiente para que o sandbox seja executado corretamente.

Parâmetros
`context`	`IInvocationContext`: a invocação atual `IInvocationContext`.
`configuration`	`IConfiguration`: o `IConfiguration` para que o comando seja executado.
`listener`	`ITestInvocationListener`: a invocação atual `ITestInvocationListener` em que os resultados finais precisam ser canalizados.

Retorna
`Exception`	um `Exception` que contém a falha ou "Null" em caso de sucesso.

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` para que o comando seja 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 abstract void tearDown ()

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