À 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.

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

java.lang.Object
↳	com.android.tradefed.sandbox.TradefedSandbox

Conteneur de bac à sable pouvant exécuter une invocation de la Trade Federation. À FAIRE: Autorisez les options à être transmises au bac à sable.

Résumé

Constructeurs publics
`TradefedSandbox()`

Méthodes publiques
`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[])`.
`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.
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Renvoie l'environnement de bac à sable TF à utiliser en fonction des arguments de ligne de commande.
`Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Préparez l'environnement pour que l'environnement de bac à sable s'exécute correctement.
`CommandResult`	`run(IConfiguration config, ITestLogger logger)` Exécutez le bac à sable avec l'environnement défini.
`void`	`tearDown()` Nettoyez tous les états, fichiers ou environnements qui ont pu être modifiés.

Méthodes protégées
`File`	`dumpGlobalConfig(IConfiguration config, exclusionPatterns)` Vider la configuration globale filtrée à partir de certains objets.
`Exception`	`prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Préparez l'`IConfiguration` qui sera transmise au sous-processus et qui pilotera l'exécution du conteneur.
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` Préparez et sérialisez `IInvocationContext`.

Constructeurs publics

TradefedSandbox

public TradefedSandbox ()

Méthodes publiques

createClasspath

public 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 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.

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.

prepareEnvironment

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                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.
`config`	`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 CommandResult run (IConfiguration config, 
                ITestLogger logger)

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

Paramètres
`config`	`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 void tearDown ()

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

Méthodes protégées

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

Vider la configuration globale filtrée à partir de certains objets.

Paramètres
`config`	`IConfiguration`
`exclusionPatterns`

Renvoie
`File`

Génère
`ConfigurationException`

prepareConfiguration

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Préparez l'IConfiguration qui sera transmise au sous-processus et qui pilotera l'exécution du conteneur.

Paramètres
`context`	`IInvocationContext`: `IInvocationContext` actuel.
`config`	`IConfiguration`: `IConfiguration` à préparer.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` d'appel actuel.

Renvoie
`Exception`	Une exception si un problème est survenu, sinon une valeur nulle.

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Préparez et sérialisez IInvocationContext.

Paramètres
`context`	`IInvocationContext`: `IInvocationContext` à préparer.
`config`	`IConfiguration`: `IConfiguration` du bac à sable.

Renvoie
`File`	`IInvocationContext` sérialisé.