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 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 na o pai, substituímos pelo thin launcher, onde tentamos configurar o sandbox informações conhecidas e preencha o diretório de trabalho para criar a configuração totalmente no com controle de versão.
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 o 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 os arquivos adicionais 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) Preparar o ambiente para que o sandbox seja executado corretamente.
abstract CommandResult	run(TestInformation info, IConfiguration configuration, ITestLogger logger) Execute o sandbox com o ambiente configurado.
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 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.

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 parece não existir na o pai, substituímos pelo thin launcher, onde tentamos configurar o sandbox informações conhecidas e preencha o diretório de trabalho para criar a configuração totalmente no com controle de 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. Devoluções nulo se nenhuma configuração de tela de início simplificada puder ser criada.

discoveryTests

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 o SandboxOptions.shouldUseTestDiscovery() está ativado.

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

Retorna
	O mapa de testes descobertos ou nulo, se não for compatível ou falhar.

discoveryTests

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

Parâmetros
context	IInvocationContext
configuration	IConfiguration
logger	ITestLogger

Retorna

buscaSandboxExtraArtifacts

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

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

Retorna
IFolderBuildInfo	a compilação buscada para os arquivos adicionais no 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 controle de versão.
args	String: os argumentos da linha de comando.

Retorna
File	um diretório ERROR(/File) contendo os jars 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)

Preparar o ambiente para que o sandbox seja executado corretamente.

Parâmetros
context	IInvocationContext: a invocação atual IInvocationContext.
configuration	IConfiguration: o IConfiguration do comando a ser executado.
listener	ITestInvocationListener: a invocação atual ITestInvocationListener em que os resultados finais são exibidos. deve ser encadeado.

Retorna
Exception	um Exception contendo a falha. ou "Nulo" em caso de êxito.

run

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

Execute o sandbox com o ambiente configurado.

Parâmetros
info	TestInformation: o TestInformation que descreve a invocação
configuration	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 do sandbox e dos registros.

desmontar

public abstract void tearDown ()

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