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

Champs
`public static final String`	`EXTRA_TARGET_LAB`
`public static final String`	`GENERAL_TESTS_ZIP`
`public static final String`	`SANDBOX_ENABLED`

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 `ISandbox.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, ITestLogger logger, String[] args)`
`static`	`matchSandboxExtraBuildTargetByConfigName(String configName)` À partir du nom de la configuration de test, faites correspondre les cibles de compilation supplémentaires de l'environnement de simulation.
`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(TestInformation info, 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.
`String`	`getJava()`
`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`.

Champs

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

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 ISandbox.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, 
                ITestLogger logger, 
                String[] args)

Paramètres
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

Renvoie
`File`

matchSandboxExtraBuildTargetByConfigName

public static  matchSandboxExtraBuildTargetByConfigName (String configName)

À partir du nom de la configuration de test, faites correspondre les cibles de compilation supplémentaires de l'environnement de simulation.

Paramètres
`configName`	`String`

Renvoie

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 (TestInformation info, 
                IConfiguration config, 
                ITestLogger logger)

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

Paramètres
`info`	`TestInformation`: `TestInformation` décrivant l'appel
`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`

getJava

protected String getJava ()

Renvoie
`String`

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

Génère
	IOException