A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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

Sottoclassi dirette note

GoogleTradefedSandbox

GoogleTradefedSandbox Specializzazione interna di TradefedSandbox da utilizzare nell'infrastruttura del lab.

Container sandbox in grado di eseguire una chiamata Trade Federation. TODO: Allow Options to be passed to the sandbox.

Riepilogo

Costanti
`String`	`EXTRA_TARGET_LAB`
`String`	`GENERAL_TESTS_ZIP`
`String`	`SANDBOX_ENABLED`

Costruttori pubblici
`TradefedSandbox()`

Metodi pubblici
`String`	`createClasspath(File workingDir)` Crea un classpath basato sull'ambiente e sulla directory di lavoro restituita da `getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[])`.
`IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` Modalità speciale disconnessa dall'esecuzione principale: quando una configurazione non sembra esistere nel parent, viene eseguito il fallback al launcher thin, in cui tentiamo di configurare la sandbox con le informazioni attualmente note e riempiamo la directory di lavoro per creare completamente la configurazione nella directory con controllo delle versioni.
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`static Set<String>`	`matchSandboxExtraBuildTargetByConfigName(String configName)` Dato il nome della configurazione di test, abbina i target di build aggiuntivi ai target di build aggiuntivi di Sandbox.
`Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Prepara l'ambiente per l'esecuzione corretta della sandbox.
`static String[]`	`removeIncompatibleFlags(String[] args)`
`CommandResult`	`run(TestInformation info, IConfiguration config, ITestLogger logger)` Esegui la sandbox con l'ambiente impostato.
`void`	`tearDown()` Ripulisci eventuali stati, file o ambienti che potrebbero essere stati modificati.

Metodi protetti
`File`	`dumpGlobalConfig(IConfiguration config, Set<String> exclusionPatterns)` Eseguire il dump della configurazione globale filtrata da alcuni oggetti.
`String`	`getJava()`
`Exception`	`prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Prepara il `IConfiguration` che verrà passato al sottoprocesso e che guiderà l'esecuzione del container.
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` Prepara e serializza `IInvocationContext`.

Costanti

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

Valore costante: "lab"

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

Valore costante: "general-tests.zip"

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

Valore costante: "SANDBOX_ENABLED"

Costruttori pubblici

TradefedSandbox

public TradefedSandbox ()

Metodi pubblici

createClasspath

public String createClasspath (File workingDir)

Crea un classpath basato sull'ambiente e sulla directory di lavoro restituita da getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]).

Parametri
`workingDir`	`File`: la directory di lavoro corrente per la sandbox.

Resi
`String`	Il classpath da utilizzare.

Genera
`ConfigurationException`

createThinLauncherConfig

public IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

Modalità speciale disconnessa dall'esecuzione principale: quando una configurazione non sembra esistere nel parent, viene eseguito il fallback al launcher thin, in cui tentiamo di configurare la sandbox con le informazioni attualmente note e riempiamo la directory di lavoro per creare completamente la configurazione nella directory con controllo delle versioni.

Parametri
`args`	`String`: Gli argomenti della riga di comando originali.
`keyStoreClient`	`IKeyStoreClient`: il client keystore attuale da utilizzare per creare le configurazioni.
`runUtil`	`IRunUtil`: l'attuale `IRunUtil` per eseguire i comandi host.
`globalConfig`	`File`: La configurazione globale da utilizzare per eseguire i sottoprocessi di TF.

Resi
`IConfiguration`	Un file che punta al file XML di configurazione di TF per gli oggetti NON_VERSIONED. Restituisce null se non è stato possibile creare alcuna configurazione di avvio leggero.

getTradefedSandboxEnvironment

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

Parametri
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

Resi
`File`

Genera
`Exception`

matchSandboxExtraBuildTargetByConfigName

public static Set<String> matchSandboxExtraBuildTargetByConfigName (String configName)

Dato il nome della configurazione di test, abbina i target di build aggiuntivi ai target di build aggiuntivi di Sandbox.

Parametri
`configName`	`String`

Resi
`Set<String>`

prepareEnvironment

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

Prepara l'ambiente per l'esecuzione corretta della sandbox.

Parametri
`context`	`IInvocationContext`: l'attuale chiamata `IInvocationContext`.
`config`	`IConfiguration`: il `IConfiguration` per il comando da eseguire.
`listener`	`ITestInvocationListener`: l'invocazione `ITestInvocationListener` corrente in cui devono essere inseriti i risultati finali.

Resi
`Exception`	un `Exception` contenente l'errore o Null in caso di esito positivo.

removeIncompatibleFlags

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

Parametri
`args`	`String`

Resi
`String[]`

run

public CommandResult run (TestInformation info, 
                IConfiguration config, 
                ITestLogger logger)

Esegui la sandbox con l'ambiente impostato.

Parametri
`info`	`TestInformation`: il `TestInformation` che descrive la chiamata
`config`	`IConfiguration`: il `IConfiguration` per il comando da eseguire.
`logger`	`ITestLogger`: un `ITestLogger` in cui possiamo registrare i file di log.

Resi
`CommandResult`	un `CommandResult` con lo stato dell'esecuzione della sandbox e i log.

Genera
`Throwable`

tearDown

public void tearDown ()

Ripulisci eventuali stati, file o ambienti che potrebbero essere stati modificati.

Metodi protetti

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                Set<String> exclusionPatterns)

Eseguire il dump della configurazione globale filtrata da alcuni oggetti.

Parametri
`config`	`IConfiguration`
`exclusionPatterns`	`Set`

Resi
`File`

Genera
`ConfigurationException`
`IOException`

getJava

protected String getJava ()

Resi
`String`

prepareConfiguration

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

Prepara il IConfiguration che verrà passato al sottoprocesso e che guiderà l'esecuzione del container.

Parametri
`context`	`IInvocationContext`: il `IInvocationContext` attuale.
`config`	`IConfiguration`: il `IConfiguration` da preparare.
`listener`	`ITestInvocationListener`: La chiamata corrente `ITestInvocationListener`.

Resi
`Exception`	un'eccezione se si è verificato un problema, null in caso contrario.

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Prepara e serializza IInvocationContext.

Parametri
`context`	`IInvocationContext`: il `IInvocationContext` da preparare.
`config`	`IConfiguration`: il `IConfiguration` della sandbox.

Resi
`File`	`IInvocationContext` serializzato.

Genera
	java.io.IOException
`IOException`