Cette page a été traduite par l'API Cloud Translation.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Sous-classes indirectes connues

TradefedSandbox Conteneur de bac à sable pouvant exécuter un appel de fédération de commerce.

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 d'accès aux classes 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 des informations connues et remplissez le répertoire de travail pour créer la configuration répertoire avec versions gérées
`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étecte les 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 le fichier TF de l'environnement de bac à sable à 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 qui a été 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 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`: répertoire de travail actuel du bac à sable.

Renvoie
`String`	Chemin de classe à 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 revenons au lanceur léger où nous essayons de configurer le bac à sable avec des informations connues et remplissez le répertoire de travail pour créer la configuration répertoire avec versions gérées

Paramètres
`args`	`String`: arguments de ligne de commande d'origine
`keyStoreClient`	`IKeyStoreClient`: client keystore actuel à utiliser pour créer des configurations.
`runUtil`	`IRunUtil`: `IRunUtil` actuel pour exécuter les commandes d'hôte.
`globalConfig`	`File`: configuration globale à utiliser pour exécuter les sous-processus de TF.

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

Tests

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étecte les tests si SandboxOptions.shouldUseTestDiscovery() est activé.

Paramètres
`context`	`IInvocationContext`: appel actuel (`IInvocationContext`).
`configuration`	`IConfiguration`: `IConfiguration` pour la commande à exécuter.

Renvoie
	Carte des tests découverts, ou valeur nulle s'il n'est pas pris en charge ou s'il a échoué.

Tests

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

Paramètres
`context`	`IInvocationContext`
`configuration`	`IConfiguration`
`logger`	`ITestLogger`

Renvoie

récupérerSandboxExtraArtifacts

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`: appel actuel (`IInvocationContext`).
`configuration`	`IConfiguration`: `IConfiguration` pour la commande à exécuter.
`args`	`String`: arguments de ligne de commande

Renvoie
`IFolderBuildInfo`	la compilation récupérée pour les fichiers supplémentaires en 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 le fichier TF de l'environnement de bac à sable à utiliser en fonction des arguments de ligne de commande.

Paramètres
`context`	`IInvocationContext`: `IInvocationContext` du parent.
`nonVersionedConfig`	`IConfiguration`: `IConfiguration` représentant les objets sans gestion des versions.
`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`

Préparer l'environnement

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`: appel actuel (`IInvocationContext`).
`configuration`	`IConfiguration`: `IConfiguration` pour la commande à exécuter.
`listener`	`ITestInvocationListener`: appel actuel `ITestInvocationListener` où les résultats finaux sont générés doit être dirigée.

Renvoie
`Exception`	Un `Exception` contenant l'échec. ou Null 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 qui a été défini.

Paramètres
`info`	`TestInformation`: le `TestInformation` décrivant l'appel.
`configuration`	`IConfiguration`: `IConfiguration` pour la commande à exécuter.
`logger`	`ITestLogger`: un `ITestLogger` dans lequel nous pouvons stocker des fichiers journaux.

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

suppression

public abstract void tearDown ()

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