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

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`