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 essayons de configurer le bac à sable avec les informations actuellement connues et remplissons le répertoire de travail pour créer entièrement la configuration dans le répertoire versionné. .

default discoverTests ( IInvocationContext context, IConfiguration configuration)

Une sous-étape de prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) qui découvre des tests si SandboxOptions.shouldUseTestDiscovery() est activé.

default discoverTests ( IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo fetchSandboxExtraArtifacts ( IInvocationContext context, IConfiguration configuration, String[] args)

Sous-étape de prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) qui récupère les fichiers supplémentaires nécessaires au bac à sable.

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

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

default File getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
abstract Exception prepareEnvironment ( IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)

Préparez l'environnement pour que le bac à sable fonctionne correctement.

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

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

abstract void tearDown ()

Nettoyez tous les états, fichiers ou environnements qui pourraient 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 du bac à sable.

Retour
String Le chemin de classe à utiliser.

Jetés
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 essayons de configurer le bac à sable avec les informations actuellement connues et remplissons le répertoire de travail pour créer entièrement la configuration dans le répertoire versionné. .

Paramètres
args String : Les arguments de la 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 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.

découvrirTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Une sous-étape de prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) qui découvre des tests si SandboxOptions.shouldUseTestDiscovery() est activé.

Paramètres
context IInvocationContext : l'appel actuel IInvocationContext .

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

Retour
La carte des tests découverts ou null s'ils ne sont pas pris en charge ou ont échoué.

découvrirTests

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

Paramètres
context IInvocationContext

configuration IConfiguration

logger ITestLogger

Retour

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

Sous-étape de prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) qui récupère les fichiers supplémentaires nécessaires au bac à sable.

Paramètres
context IInvocationContext : l'appel actuel IInvocationContext .

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

args String : les arguments de la ligne de commande.

Retour
IFolderBuildInfo la version récupérée pour les fichiers supplémentaires en bac à sable.

Jetés
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.config.ConfigurationException
IOException
BuildRetrievalError
ConfigurationException

getTradefedSandboxEnvironment

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

Renvoie l'environnement sandbox TF à utiliser en fonction des arguments de 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 TF sandbox.

getTradefedSandboxEnvironment

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

Paramètres
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

Retour
File

préparerEnvironnement

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

Préparez l'environnement pour que le bac à sable fonctionne correctement.

Paramètres
context IInvocationContext : l'appel actuel IInvocationContext .

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

listener ITestInvocationListener : l'invocation actuelle ITestInvocationListener vers laquelle les résultats finaux doivent être redirigés.

Retour
Exception une 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 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 du bac à sable et des journaux.

démolir

public abstract void tearDown ()

Nettoyez tous les états, fichiers ou environnements qui pourraient avoir été modifiés.