ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


Interfaccia che definisce un sandbox che può essere utilizzato 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 sembra non esistere nel genitore, ricorriamo al thin launcher dove proviamo a configurare il sandbox con le informazioni attualmente note e riempire la directory di lavoro per creare la configurazione completamente nella directory con versione .

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() è abilitato.

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 il TF dell'ambiente sandbox 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)

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 eventuali stati, file o ambienti 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 classpath da utilizzare.

Lancia
ConfigurationException

createThinLauncherConfig

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

Modalità speciale disconnessa dall'esecuzione principale: quando una configurazione sembra non esistere nel genitore, ricorriamo al thin launcher dove proviamo a configurare il sandbox con le informazioni attualmente note e riempire la directory di lavoro per creare la configurazione completamente nella directory con versione .

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

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

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

globalConfig File : la configurazione globale da utilizzare per eseguire i sottoprocessi 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 alcuna configurazione del thin launcher.

scopriTest

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() è abilitato.

Parametri
context IInvocationContext : la chiamata corrente IInvocationContext .

configuration IConfiguration : IConfiguration per il comando da eseguire.

ritorna
La mappa dei test rilevati o nulli se non supportati o non riusciti.

scopriTest

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

Parametri
context IInvocationContext

configuration IConfiguration

logger ITestLogger

ritorna

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 corrente IInvocationContext .

configuration IConfiguration : IConfiguration per il comando da eseguire.

args String : gli argomenti della riga di comando.

ritorna
IFolderBuildInfo la build recuperata per i file sandbox aggiuntivi.

Lancia
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.config.ConfigurationException
IOException
BuildRetrievalError
ConfigurationException

getTradefedSandboxEnvironment

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

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

Parametri
context IInvocationContext : l' 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.

getTradefedSandboxEnvironment

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

Parametri
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

ritorna
File

preparareAmbiente

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

Preparare l'ambiente affinché la sandbox funzioni correttamente.

Parametri
context IInvocationContext : la chiamata corrente IInvocationContext .

configuration IConfiguration : IConfiguration per il comando da eseguire.

listener ITestInvocationListener : la chiamata corrente ITestInvocationListener a cui devono essere reindirizzati i risultati finali.

ritorna
Exception Exception contenente l'errore. o Null in caso di successo.

correre

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

Esegui la sandbox con l'ambiente impostato.

Parametri
info TestInformation : TestInformation che descrive l'invocazione

configuration IConfiguration : IConfiguration per il comando da eseguire.

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

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

demolire

public abstract void tearDown ()

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