Esta página foi traduzida pela API Cloud Translation.

Caixa de areia

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Subclasses indiretas conhecidas

Caixa de areia negociada Contêiner sandbox que pode executar uma invocação da Federação Comercial.

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 caminho de classe 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 parece não existir no pai, voltamos para o thin launcher, onde tentamos configurar o sandbox com informações atualmente conhecidas e preencher o diretório de trabalho para criar a configuração totalmente no diretório versionado .
`default`	`discoverTests ( IInvocationContext context, IConfiguration configuration)` Uma subetapa de `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` que descobre testes se `SandboxOptions.shouldUseTestDiscovery()` estiver habilitado.
`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 arquivos adicionais necessários para o sandbox.
`default File`	`getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Retorna o ambiente sandbox 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 o sandbox funcione corretamente.
`abstract CommandResult`	`run ( TestInformation info, IConfiguration configuration, ITestLogger logger)` Execute o sandbox com o ambiente que foi configurado.
`abstract void`	`tearDown ()` Limpe quaisquer estados, arquivos ou ambientes que possam ter sido alterados.

Métodos públicos

criarClasspath

public abstract String createClasspath (File workingDir)

Crie um caminho de classe 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.

Devoluções
`String`	O caminho de classe a ser usado.

Lança
`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 parece não existir no pai, voltamos para o thin launcher, onde tentamos configurar o sandbox com informações atualmente conhecidas e preencher o diretório de trabalho para criar a configuração totalmente no diretório versionado .

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 de host.
`globalConfig`	`File` : A configuração global a ser usada para executar subprocessos do TF.

Devoluções
`IConfiguration`	a Arquivo apontando para o XML de configuração do TF para objetos NON_VERSIONED. Retorna nulo se nenhuma configuração do iniciador fino puder ser criada.

descobrirTestes

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Uma subetapa de prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) que descobre testes se SandboxOptions.shouldUseTestDiscovery() estiver habilitado.

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

Devoluções
	O mapa de testes descobertos ou nulo se não houver suporte ou falhar.

descobrirTestes

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

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

Devoluções

buscarSandboxExtraArtifacts

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 arquivos adicionais necessários para o sandbox.

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

Devoluções
`IFolderBuildInfo`	a compilação buscada para os arquivos adicionais em área restrita.

Lança
	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 ambiente sandbox TF 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.

Devoluções
`File`	um diretório `ERROR(/File)` contendo os jars do ambiente sandbox TF.

getTradefedSandboxEnvironment

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

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

Devoluções
`File`

prepararAmbiente

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

Prepare o ambiente para que o sandbox funcione corretamente.

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

Devoluções
`Exception`	uma `Exception` contendo a falha. ou Nulo se for bem-sucedido.

correr

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

Execute o sandbox com o ambiente que foi configurado.

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

Devoluções
`CommandResult`	um `CommandResult` com o status da execução e dos logs do sandbox.

destruir

public abstract void tearDown ()

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