ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Sottoclassi indirette conosciute

TradefedSandbox

TradefedSandbox Contenitore sandbox in grado di eseguire una chiamata di Trade Federation.

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 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 nel genitore, ricadiamo su thin launcher dove tentiamo di configurare la sandbox con le informazioni attualmente note e riempire la directory di lavoro per creare la configurazione completamente nella directory con versione .
`abstract File`	`getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Restituisce l'ambiente sandbox TF da utilizzare in base agli argomenti della riga di comando.
`abstract Exception`	`prepareEnvironment ( IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)` Preparare l'ambiente affinché la sandbox funzioni correttamente.
`abstract CommandResult`	`run ( TestInformation info, IConfiguration configuration, ITestLogger logger)` Esegui la sandbox con l'ambiente impostato.
`abstract void`	`tearDown ()` Pulisci tutti gli stati, i file o l'ambiente che potrebbero essere stati modificati.

Metodi pubblici

createClasspath

public abstract String createClasspath (File workingDir)

Crea un percorso di classe 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.

ritorna
`String`	Il percorso di classe da utilizzare.

Tiri
`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 genitore, ricadiamo su thin launcher dove tentiamo di configurare la sandbox con le informazioni attualmente note e riempire la directory di lavoro per creare la configurazione completamente nella directory con versione .

Parametri
`args`	`String` : la riga di comando originale args.
`keyStoreClient`	`IKeyStoreClient` : il client keystore corrente da usare per creare configurazioni.
`runUtil`	`IRunUtil` : l'attuale `IRunUtil` per eseguire i comandi host.
`globalConfig`	`File` : la configurazione globale da utilizzare per eseguire i processi secondari di TF.

ritorna
`IConfiguration`	un File che punta all'XML di configurazione di TF per oggetti NON_VERSIONED. Restituisce null se non è stato possibile creare una configurazione thin launcher.

getTradefedSandboxEnvironment

public abstract 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` : `IInvocationContext` del genitore.
`nonVersionedConfig`	`IConfiguration` : la `IConfiguration` che rappresenta gli oggetti senza versione.
`args`	`String` : gli argomenti della riga di comando.

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

preparareAmbiente

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

Preparare l'ambiente affinché la sandbox funzioni correttamente.

Parametri
`context`	`IInvocationContext` : l'invocazione corrente `IInvocationContext` .
`configuration`	`IConfiguration` : `IConfiguration` per l'esecuzione del comando.
`listener`	`ITestInvocationListener` : la chiamata corrente `ITestInvocationListener` cui devono essere inviati i risultati finali.

ritorna
`Exception`	`Exception` contenente l'errore. o Null in caso di esito positivo.

correre

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` : `IConfiguration` per l'esecuzione del comando.
`logger`	`ITestLogger` : un `ITestLogger` in cui possiamo registrare i file.

ritorna
`CommandResult`	un `CommandResult` con lo stato dell'esecuzione sandbox e dei log.

demolire

public abstract void tearDown ()

Pulisci tutti gli stati, i file o l'ambiente che potrebbero essere stati modificati.