À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer dans AOSP, utilisez android-latest-release. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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

Sous-classes directes connues

GoogleTradefedSandbox

GoogleTradefedSandbox Spécialisation interne de TradefedSandbox à utiliser dans l'infrastructure de l'atelier.

Conteneur de bac à sable pouvant exécuter un appel Trade Federation. TODO: Allow Options to be passed to the sandbox.

Résumé

Constantes
`String`	`EXTRA_TARGET_LAB`
`String`	`GENERAL_TESTS_ZIP`
`String`	`SANDBOX_ENABLED`

Constructeurs publics
`TradefedSandbox()`

Méthodes publiques
`String`	`createClasspath(File workingDir)` Créez un chemin de classe basé sur l'environnement et le répertoire de travail renvoyés par `getTradefedSandboxEnvironment(IInvocationContext,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 revenons au lanceur fin où nous essayons de configurer le bac à sable avec les informations actuellement connues et de remplir le répertoire de travail pour créer la configuration entièrement dans le répertoire versionné.
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`static Set<String>`	`matchSandboxExtraBuildTargetByConfigName(String configName)` À partir du nom de la configuration de test, faites correspondre les cibles de compilation supplémentaires à celles de la sandbox.
`Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Préparez l'environnement pour que le bac à sable s'exécute correctement.
`static String[]`	`removeIncompatibleFlags(String[] args)`
`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, Set<String> exclusionPatterns)` Dumps the global configuration filtered from some objects.
`String`	`getJava()`
`Exception`	`prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Préparez le `IConfiguration` qui sera transmis au sous-processus et qui pilotera l'exécution du conteneur.
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` Préparez et sérialisez le `IInvocationContext`.

Constantes

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

Valeur constante : "lab"

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

Valeur de constante : "general-tests.zip"

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

Valeur de constante : "SANDBOX_ENABLED"

Constructeurs publics

TradefedSandbox

public TradefedSandbox ()

Méthodes publiques

createClasspath

public String createClasspath (File workingDir)

Créez un chemin de classe basé sur l'environnement et le répertoire de travail renvoyés par getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]).

Paramètres
`workingDir`	`File` : répertoire de travail actuel du bac à sable.

Renvoie
`String`	Chemin d'accès à 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 revenons au lanceur fin où nous essayons de configurer le bac à sable avec les informations actuellement connues et de remplir le répertoire de travail pour créer la configuration entièrement dans le répertoire versionné.

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 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 léger n'a pu ê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`

Génère
`Exception`

matchSandboxExtraBuildTargetByConfigName

public static Set<String> matchSandboxExtraBuildTargetByConfigName (String configName)

À partir du nom de la configuration de test, faites correspondre les cibles de compilation supplémentaires à celles de la sandbox.

Paramètres
`configName`	`String`

Renvoie
`Set<String>`

prepareEnvironment

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Préparez l'environnement pour que le bac à sable s'exécute correctement.

Paramètres
`context`	`IInvocationContext` : l'appel `IInvocationContext` actuel.
`config`	`IConfiguration` : `IConfiguration` de la commande à exécuter.
`listener`	`ITestInvocationListener` : l'appel actuel `ITestInvocationListener` où les résultats finaux doivent être transmis.

Renvoie
`Exception`	un `Exception` contenant l'échec ou la valeur Null en cas de réussite.

removeIncompatibleFlags

public static String[] removeIncompatibleFlags (String[] args)

Paramètres
`args`	`String`

Renvoie
`String[]`

run

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'invocation
`config`	`IConfiguration` : `IConfiguration` de la commande à exécuter.
`logger`	`ITestLogger` : `ITestLogger` où nous pouvons enregistrer les fichiers journaux.

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

Génère
`Throwable`

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, 
                Set<String> exclusionPatterns)

Dumps the global configuration filtered from some objects.

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

Renvoie
`File`

Génère
`ConfigurationException`
`IOException`

getJava

protected String getJava ()

Renvoie
`String`

prepareConfiguration

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

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

Paramètres
`context`	`IInvocationContext` : la valeur `IInvocationContext` actuelle.
`config`	`IConfiguration` : `IConfiguration` à préparer.
`listener`	`ITestInvocationListener` : `ITestInvocationListener` de l'appel actuel.

Renvoie
`Exception`	Une exception si un problème est survenu, null dans le cas contraire.

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Préparez et sérialisez le IInvocationContext.

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

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

Génère
	java.io.IOException
`IOException`