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

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Sous-classes indirectes connues

GoogleTradefedSandbox, TradefedSandbox

GoogleTradefedSandbox	Spécialisation interne de `TradefedSandbox` à utiliser dans l'infrastructure de l'atelier.
TradefedSandbox	Conteneur de bac à sable pouvant exécuter un appel 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 de classe basé sur l'environnement et le répertoire de travail renvoyés par `getTradefedSandboxEnvironment(IInvocationContext,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 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é.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Sous-étape de `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` qui détecte les tests si `SandboxOptions.shouldUseTestDiscovery()` est activé.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` Sous-étape de `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` qui récupère les fichiers supplémentaires nécessaires au bac à sable.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Renvoie le TF de l'environnement de bac à sable à 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 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 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 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 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.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Sous-étape de prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) qui détecte les tests si SandboxOptions.shouldUseTestDiscovery() est activé.

Paramètres
`context`	`IInvocationContext` : l'appel `IInvocationContext` actuel.
`configuration`	`IConfiguration` : `IConfiguration` de la commande à exécuter.

Renvoie
`Map<String, List<String>>`	Map des tests découverts ou null si non pris en charge ou en cas d'échec.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

Paramètres
`context`	`IInvocationContext`
`configuration`	`IConfiguration`
`logger`	`ITestLogger`

Renvoie
`Map<String, List<String>>`

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

Sous-étape de prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) qui récupère les fichiers supplémentaires nécessaires au bac à sable.

Paramètres
`context`	`IInvocationContext` : l'appel `IInvocationContext` actuel.
`configuration`	`IConfiguration` : `IConfiguration` de la commande à exécuter.
`args`	`String` : arguments de ligne de commande.

Renvoie
`IFolderBuildInfo`	la version récupérée pour les fichiers sandbox supplémentaires.

Génère
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	java.io.IOException
`BuildRetrievalError`
`ConfigurationException`
`IOException`

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

Renvoie le TF de l'environnement de bac à sable à 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 `File` contenant les fichiers JAR de l'environnement bac à sable TF.

Génère
`Exception`

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`

prepareEnvironment

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

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

Paramètres
`context`	`IInvocationContext` : l'appel `IInvocationContext` actuel.
`configuration`	`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.

run

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'invocation
`configuration`	`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 abstract void tearDown ()

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