Caixa de areia

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

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

Retorna o ambiente sandbox TF 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 funcione corretamente.

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

getTradefedSandboxEnvironment

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

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

Execute o sandbox com o ambiente que foi configurado.

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