ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


Interfaccia che definisce una sandbox che può essere utilizzata per eseguire una chiamata.

Riepilogo

Metodi pubblici

abstract String createClasspath(File workingDir)

Crea un classpath basato sull'ambiente e sulla directory di lavoro restituita da getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]).

abstract IConfiguration createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)

Modalità speciale disconnessa dall'esecuzione principale: quando una configurazione non sembra esistere in principale, ricorriamo al thin launcher, dove tentiamo di configurare la sandbox con informazioni note e riempire la directory di lavoro per creare la configurazione dir. con più versioni

default discoverTests(IInvocationContext context, IConfiguration configuration)

Un passaggio secondario di prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) che rileva i test se SandboxOptions.shouldUseTestDiscovery() è attivato.

default discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)

Passaggio secondario di prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) che recupera i file aggiuntivi necessari per la sandbox.

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

Restituisce l'ambiente sandbox TF da utilizzare in base agli argomenti della riga di comando.

default File getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
abstract Exception prepareEnvironment(IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)

Prepara l'ambiente per il corretto funzionamento della sandbox.

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

Esegui la sandbox con l'ambiente impostato.

abstract void tearDown()

Elimina gli stati, i file o gli ambienti che potrebbero essere stati modificati.

Metodi pubblici

createClasspath

public abstract String createClasspath (File workingDir)

Crea un classpath basato sull'ambiente e sulla directory di lavoro restituita da getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]).

Parametri
workingDir File: la directory di lavoro corrente per la sandbox.

Ritorni
String Il classpath da utilizzare.

Lanci
ConfigurationException

createThinLauncherConfig

public abstract IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

Modalità speciale disconnessa dall'esecuzione principale: quando una configurazione non sembra esistere in principale, ricorriamo al thin launcher, dove tentiamo di configurare la sandbox con informazioni note e riempire la directory di lavoro per creare la configurazione dir. con più versioni

Parametri
args String: gli argomenti originali della riga di comando.

keyStoreClient IKeyStoreClient: client dell'archivio chiavi corrente da utilizzare per creare le configurazioni.

runUtil IRunUtil: il valore IRunUtil corrente per eseguire i comandi dell'host.

globalConfig File: la configurazione globale da utilizzare per eseguire i sottoprocessi di TF.

Ritorni
IConfiguration un file che punta al file XML di configurazione di TF per gli oggetti NON_VERSIONED. Resi null se non è stato possibile creare una configurazione di Avvio app thin.

DiscoverTest

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Un passaggio secondario di prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) che rileva i test se SandboxOptions.shouldUseTestDiscovery() è attivato.

Parametri
context IInvocationContext: la chiamata IInvocationContext corrente.

configuration IConfiguration: il IConfiguration per l'esecuzione del comando.

Ritorni
Mappa dei test rilevati o nullo se non supportato o non riuscito.

DiscoverTest

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

Parametri
context IInvocationContext

configuration IConfiguration

logger ITestLogger

Ritorni

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

Passaggio secondario di prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) che recupera i file aggiuntivi necessari per la sandbox.

Parametri
context IInvocationContext: la chiamata IInvocationContext corrente.

configuration IConfiguration: il IConfiguration per l'esecuzione del comando.

args String: gli argomenti della riga di comando.

Ritorni
IFolderBuildInfo la build recuperata per i file aggiuntivi con sandbox.

Lanci
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.config.ConfigurationEccezione
Eccezione IO
BuildRetrievalError
ConfigurationException

getTradefedSandboxEnvironment

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

Restituisce l'ambiente sandbox TF da utilizzare in base agli argomenti della riga di comando.

Parametri
context IInvocationContext: il IInvocationContext dell'elemento principale.

nonVersionedConfig IConfiguration: il valore IConfiguration che rappresenta gli oggetti senza controllo delle versioni.

args String: gli argomenti della riga di comando.

Ritorni
File una directory ERROR(/File) contenente i jar dell'ambiente sandbox di TF.

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger, 
                String[] args)

Parametri
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

Ritorni
File

prepara Ambiente

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

Prepara l'ambiente per il corretto funzionamento della sandbox.

Parametri
context IInvocationContext: la chiamata IInvocationContext corrente.

configuration IConfiguration: il IConfiguration per l'esecuzione del comando.

listener ITestInvocationListener: la chiamata ITestInvocationListener corrente in cui saranno visualizzati i risultati finali deve essere inviato.

Ritorni
Exception un elemento Exception contenente l'errore. o Null se l'operazione ha esito positivo.

run

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

Esegui la sandbox con l'ambiente impostato.

Parametri
info TestInformation: il valore TestInformation che descrive la chiamata

configuration IConfiguration: il IConfiguration per l'esecuzione del comando.

logger ITestLogger: un ITestLogger in cui possiamo registrare i file.

Ritorni
CommandResult un'CommandResult con lo stato dell'esecuzione della sandbox e i log.

demolire

public abstract void tearDown ()

Elimina gli stati, i file o gli ambienti che potrebbero essere stati modificati.