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.