ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


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

Résumé

Méthodes publiques

abstract String createClasspath(File workingDir)

Créez un chemin d'accès aux classes en fonction de l'environnement et du répertoire de travail renvoyés 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 utilisons le lanceur léger pour tenter de configurer le bac à sable avec les informations actuellement connues et remplir le répertoire de travail afin de créer entièrement la configuration dans le répertoire avec version.

default discoverTests(IInvocationContext context, IConfiguration configuration)

Sous-étape de prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) qui découvre 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 de bac à sable 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 l'environnement de bac à sable s'exécute 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 ont pu être modifiés.

Méthodes publiques

createClasspath

public abstract String createClasspath (File workingDir)

Créez un chemin d'accès aux classes en fonction de l'environnement et du répertoire de travail renvoyés par getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]).

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

Renvoie
String Chemin d'accès aux classes à utiliser.

Génère
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 utilisons le lanceur léger pour tenter de configurer le bac à sable avec les informations actuellement connues et remplir le répertoire de travail afin de créer entièrement la configuration dans le répertoire avec version.

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

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

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

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

Renvoie
IConfiguration Fichier pointant vers le fichier XML de configuration de TF pour les objets NON_VERSIONED. Renvoie la valeur "null" si aucune configuration de lanceur allégé ne peut être créée.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

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

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

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

Renvoie
Carte des tests découverts ou nulle si non prise en charge ou si le test a échoué.

discoverTests

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

Paramètres
context IInvocationContext

configuration IConfiguration

logger ITestLogger

Renvoie

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: IInvocationContext d'appel actuel.

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

args String: arguments de ligne de commande.

Renvoie
IFolderBuildInfo le build extrait pour les fichiers supplémentaires dans un bac à sable.

Génère
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 de bac à sable TF à utiliser en fonction des arguments de ligne de commande.

Paramètres
context IInvocationContext: IInvocationContext du parent.

nonVersionedConfig IConfiguration: IConfiguration représentant les objets sans version.

args String: arguments de ligne de commande.

Renvoie
File un répertoire ERROR(/File) contenant les fichiers JAR de l'environnement de bac à sable TF.

getTradefedSandboxEnvironment

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

Paramètres
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

Renvoie
File

prepareEnvironment

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

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

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

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

listener ITestInvocationListener: ITestInvocationListener d'appel actuel où les résultats finaux doivent être acheminés.

Renvoie
Exception un Exception contenant l'échec ou une valeur nulle en cas de réussite.

Exécuter

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

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

Paramètres
info TestInformation: TestInformation décrivant l'appel

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

logger ITestLogger: ITestLogger dans lequel nous pouvons consigner des fichiers.

Renvoie
CommandResult un CommandResult avec l'état de l'exécution du bac à sable et les journaux.

tearDown

public abstract void tearDown ()

Nettoyez tous les états, fichiers ou environnements qui ont pu être modifiés.