ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Classi di sottoclasse indirette note TradefedSandbox TradefedSandbox Container sandbox che può eseguire un'invocazione della Federazione commerciale.

---

Interfaccia che definisce una sandbox che può essere utilizzata per eseguire un'invocazione.

Riepilogo

Metodi pubblici
abstract String	createClasspath(File workingDir) Crea un percorso di classe in base all'ambiente e alla 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 nel processo principale, torniamo al programma di avvio ridotto, dove tentiamo di configurare la sandbox con le informazioni attualmente conosciute e riempiamo la directory di lavoro per creare completamente la configurazione nella directory con versione.
default	discoverTests(IInvocationContext context, IConfiguration configuration) Un sottopassaggio 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 l'esecuzione corretta della sandbox.
abstract CommandResult	run(TestInformation info, IConfiguration configuration, ITestLogger logger) Esegui la sandbox con l'ambiente impostato.
abstract void	tearDown() Ripulisci eventuali stati, file o ambienti che potrebbero essere stati modificati.

Metodi pubblici

createClasspath

public abstract String createClasspath (File workingDir)

Crea un percorso di classe in base all'ambiente e alla 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 percorso del 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 nel processo principale, torniamo al programma di avvio ridotto, dove tentiamo di configurare la sandbox con le informazioni attualmente conosciute e riempiamo la directory di lavoro per creare completamente la configurazione nella directory con versione.

Parametri
args	String: gli argomenti della riga di comando originali.
keyStoreClient	IKeyStoreClient: il client del keystore corrente da utilizzare per creare le configurazioni.
runUtil	IRunUtil: l'IRunUtil corrente per eseguire i comandi host.
globalConfig	File: la configurazione globale da utilizzare per eseguire i sottoprocessi di TF.

Ritorni
IConfiguration	Un file che rimanda al file XML di configurazione di TF per gli oggetti NON_VERSIONED. Restituisce null se non è stato possibile creare una configurazione del programma di avvio ridotto.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Un sottopassaggio 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: l'invocazione corrente IInvocationContext.
configuration	IConfiguration: il IConfiguration per il comando da eseguire.

Ritorni
	La mappa dei test rilevati o null se non supportati o non riusciti.

discoverTests

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: l'invocazione corrente IInvocationContext.
configuration	IConfiguration: il IConfiguration per il comando da eseguire.
args	String: gli argomenti della riga di comando.

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

Lanci
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	IOException
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'account principale.
nonVersionedConfig	IConfiguration: il IConfiguration che rappresenta gli oggetti non sottoposti al controllo delle versioni.
args	String: gli argomenti della riga di comando.

Ritorni
File	una directory ERROR(/File) contenente i file 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

prepareEnvironment

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

Prepara l'ambiente per l'esecuzione corretta della sandbox.

Parametri
context	IInvocationContext: l'invocazione corrente IInvocationContext.
configuration	IConfiguration: il IConfiguration per il comando da eseguire.
listener	ITestInvocationListener: l'attuale chiamata ITestInvocationListener a cui devono essere incanalati i risultati finali.

Ritorni
Exception	un Exception contenente l'errore o Null se l'operazione è riuscita.

run

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

Esegui la sandbox con l'ambiente impostato.

Parametri
info	TestInformation: il TestInformation che descrive l'invocazione
configuration	IConfiguration: il IConfiguration per il comando da eseguire.
logger	ITestLogger: un ITestLogger in cui possiamo registrare i file.

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

tearDown

public abstract void tearDown ()

Ripulisci eventuali stati, file o ambienti che potrebbero essere stati modificati.