TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

java.lang.Object
↳	com.android.tradefed.sandbox.TradefedSandbox

---

Container sandbox in grado di eseguire una chiamata Trade Federation. TODO: Allow Options to be passed to the sandbox.

Riepilogo

Costanti
String	EXTRA_TARGET_LAB
String	GENERAL_TESTS_ZIP
String	SANDBOX_ENABLED

Costruttori pubblici
TradefedSandbox()

Metodi pubblici
String	createClasspath(File workingDir) Crea un classpath basato sull'ambiente e sulla directory di lavoro restituita da ISandbox.getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]).
IConfiguration	createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig) Modalità speciale disconnessa dall'esecuzione principale: quando una configurazione non sembra esistere nel parent, viene eseguito il fallback al launcher thin, in cui tentiamo di configurare la sandbox con le informazioni attualmente note e riempiamo la directory di lavoro per creare completamente la configurazione nella directory con controllo delle versioni.
File	getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
static	matchSandboxExtraBuildTargetByConfigName(String configName) Dato il nome della configurazione di test, abbina i target di build aggiuntivi ai target di build aggiuntivi di Sandbox.
Exception	prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener) Prepara l'ambiente in modo che la sandbox funzioni correttamente.
CommandResult	run(TestInformation info, IConfiguration config, ITestLogger logger) Esegui la sandbox con l'ambiente impostato.
void	tearDown() Pulisci eventuali stati, file o ambienti che potrebbero essere stati modificati.

Metodi protetti
File	dumpGlobalConfig(IConfiguration config, exclusionPatterns) Esegui il dump della configurazione globale filtrata da alcuni oggetti.
String	getJava()
Exception	prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener) Prepara il IConfiguration che verrà passato al sottoprocesso e che guiderà l'esecuzione del container.
File	prepareContext(IInvocationContext context, IConfiguration config) Prepara e serializza IInvocationContext.

Costanti

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

Valore costante: "lab"

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

Constant Value: "general-tests.zip"

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

Constant Value: "SANDBOX_ENABLED"

Costruttori pubblici

TradefedSandbox

public TradefedSandbox ()

Metodi pubblici

createClasspath

public String createClasspath (File workingDir)

Crea un classpath basato sull'ambiente e sulla directory di lavoro restituita da ISandbox.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 IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

Modalità speciale disconnessa dall'esecuzione principale: quando una configurazione non sembra esistere nel parent, viene eseguito il fallback al launcher thin, in cui tentiamo di configurare la sandbox con le informazioni attualmente note e riempiamo la directory di lavoro per creare completamente la configurazione nella directory con controllo delle versioni.

Parametri
args	String: Gli argomenti della riga di comando originali.
keyStoreClient	IKeyStoreClient: il client keystore attuale da utilizzare per creare le configurazioni.
runUtil	IRunUtil: l'attuale IRunUtil per eseguire i comandi 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. Restituisce null se non è stato possibile creare alcuna configurazione di avvio leggero.

getTradefedSandboxEnvironment

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

Parametri
context	IInvocationContext
nonVersionedConfig	IConfiguration
logger	ITestLogger
args	String

Ritorni
File

matchSandboxExtraBuildTargetByConfigName

public static  matchSandboxExtraBuildTargetByConfigName (String configName)

Dato il nome della configurazione di test, abbina i target di build aggiuntivi ai target di build aggiuntivi di Sandbox.

Parametri
configName	String

Ritorni

prepareEnvironment

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Prepara l'ambiente in modo che la sandbox funzioni correttamente.

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

Ritorni
Exception	un oggetto Exception contenente l'errore o Null in caso di esito positivo.

run

public CommandResult run (TestInformation info, 
                IConfiguration config, 
                ITestLogger logger)

Esegui la sandbox con l'ambiente impostato.

Parametri
info	TestInformation: il TestInformation che descrive la chiamata
config	IConfiguration: il IConfiguration per il comando da eseguire.
logger	ITestLogger: un ITestLogger in cui possiamo registrare i file di log.

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

tearDown

public void tearDown ()

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

Metodi protetti

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

Esegui il dump della configurazione globale filtrata da alcuni oggetti.

Parametri
config	IConfiguration
exclusionPatterns

Ritorni
File

Lanci
ConfigurationException

getJava

protected String getJava ()

Ritorni
String

prepareConfiguration

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Prepara il IConfiguration che verrà passato al sottoprocesso e che guiderà l'esecuzione del container.

Parametri
context	IInvocationContext: l'attuale IInvocationContext.
config	IConfiguration: il IConfiguration da preparare.
listener	ITestInvocationListener: La chiamata attuale ITestInvocationListener.

Ritorni
Exception	un'eccezione se si è verificato un problema, altrimenti null.

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Prepara e serializza IInvocationContext.

Parametri
context	IInvocationContext: il IInvocationContext da preparare.
config	IConfiguration: il IConfiguration della sandbox.

Ritorni
File	IInvocationContext serializzato.

Lanci
	IOException