À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

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

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Sous-classes indirectes connues

TradefedSandbox

TradefedSandbox Conteneur de bac à sable pouvant exécuter une invocation de la Trade Federation.

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.