ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


Interface définissant un bac à sable pouvant être utilisé pour exécuter un appel.

Résumé

Méthodes publiques

abstract String createClasspath (File workingDir)

Créez un chemin de classe basé sur l'environnement et le répertoire de travail renvoyé par getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) .

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

Mode spécial déconnecté de l'exécution principale : lorsqu'une configuration ne semble pas exister dans le parent, nous revenons au lanceur léger où nous tentons de configurer le bac à sable avec les informations actuellement connues et de remplir le répertoire de travail pour créer la configuration entièrement dans le répertoire versionné .

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

Renvoie l'environnement sandbox TF à utiliser en fonction des arguments de la ligne de commande.

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

Préparez l'environnement pour que le bac à sable s'exécute correctement.

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

Exécutez le bac à sable avec l'environnement qui a été défini.

abstract void tearDown ()

Nettoyez tous les états, fichiers ou environnement qui peuvent avoir été modifiés.

Méthodes publiques

créer un chemin de classe

public abstract String createClasspath (File workingDir)

Créez un chemin de classe basé sur l'environnement et le répertoire de travail renvoyé par getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) .

Paramètres
workingDir File : le répertoire de travail actuel pour le bac à sable.

Retour
String Le chemin de classe à utiliser.

Lance
ConfigurationException

createThinLauncherConfig

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

Mode spécial déconnecté de l'exécution principale : lorsqu'une configuration ne semble pas exister dans le parent, nous revenons au lanceur léger où nous tentons de configurer le bac à sable avec les informations actuellement connues et de remplir le répertoire de travail pour créer la configuration entièrement dans le répertoire versionné .

Paramètres
args String : les arguments de ligne de commande d'origine.

keyStoreClient IKeyStoreClient : le client keystore actuel à utiliser pour créer des configurations.

runUtil IRunUtil : l' IRunUtil actuel pour exécuter les commandes de l'hôte.

globalConfig File : La configuration globale à utiliser pour exécuter les sous-processus de TF.

Retour
IConfiguration un Fichier pointant vers le XML de configuration de TF pour les objets NON_VERSIONED. Renvoie null si aucune configuration de lanceur léger n'a pu être créée.

getTradefedSandboxEnvironment

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

Renvoie l'environnement sandbox TF à utiliser en fonction des arguments de la ligne de commande.

Paramètres
context IInvocationContext : le IInvocationContext du parent.

nonVersionedConfig IConfiguration : la IConfiguration représentant les objets non versionnés.

args String : les arguments de la ligne de commande.

Retour
File un répertoire ERROR(/File) contenant les fichiers JAR de l'environnement sandbox TF.

préparerEnvironnement

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

Préparez l'environnement pour que le bac à sable s'exécute correctement.

Paramètres
context IInvocationContext : l'invocation actuelle IInvocationContext .

configuration IConfiguration : la IConfiguration de la commande à exécuter.

listener ITestInvocationListener : l'invocation actuelle ITestInvocationListener où les résultats finaux doivent être canalisés.

Retour
Exception une ERROR(/Exception) contenant l'échec. ou Null en cas de succès.

courir

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

Exécutez le bac à sable avec l'environnement qui a été défini.

Paramètres
info TestInformation : le TestInformation décrivant l'invocation

configuration IConfiguration : la IConfiguration de la commande à exécuter.

logger ITestLogger : un ITestLogger où nous pouvons enregistrer des fichiers.

Retour
CommandResult un CommandResult avec l'état de l'exécution de la sandbox et des journaux.

démolir

public abstract void tearDown ()

Nettoyez tous les états, fichiers ou environnement qui peuvent avoir été modifiés.