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

Switch to English

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Sous-classes indirectes connues

Bac à sable Tradefed

Bac à sable Tradefed Conteneur sandbox qui peut exécuter un appel de Trade Federation.

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.