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 .

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.