ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


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.

abstract 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.

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

Prepare o ambiente para que o sandbox seja executado corretamente.

abstract CommandResult run(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.

getTradefedSandboxEnvironment

public abstract 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.

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 (IConfiguration configuration, 
                ITestLogger logger)

Execute o sandbox com o ambiente definido.

Parâmetros
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.