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.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Sottoclassi indirette note

GoogleTradefedSandbox, TradefedSandbox

GoogleTradefedSandbox	Specializzazione interna di `TradefedSandbox` da utilizzare nell'infrastruttura del lab.
TradefedSandbox	Container sandbox in grado di eseguire una chiamata Trade Federation.

Interfaccia che definisce una sandbox che può essere utilizzata per eseguire una chiamata.

Riepilogo

Metodi pubblici
`abstract String`	`createClasspath(File workingDir)` Crea un classpath basato sull'ambiente e sulla directory di lavoro restituita da `getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[])`.
`abstract 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.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Un passaggio secondario di `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` che rileva i test se `SandboxOptions.shouldUseTestDiscovery()` è abilitato.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` Sotto-passaggio di `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` che recupera i file aggiuntivi necessari per la sandbox.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Restituisce l'ambiente sandbox TF da utilizzare in base agli argomenti della riga di comando.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`abstract Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)` Prepara l'ambiente per l'esecuzione corretta della sandbox.
`abstract CommandResult`	`run(TestInformation info, IConfiguration configuration, ITestLogger logger)` Esegui la sandbox con l'ambiente impostato.
`abstract void`	`tearDown()` Ripulisci eventuali stati, file o ambienti che potrebbero essere stati modificati.

Metodi pubblici

createClasspath

public abstract 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 abstract 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.

discoverTests

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

Un passaggio secondario di prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) che rileva i test se SandboxOptions.shouldUseTestDiscovery() è abilitato.

Parametri
`context`	`IInvocationContext`: l'attuale chiamata `IInvocationContext`.
`configuration`	`IConfiguration`: il `IConfiguration` per il comando da eseguire.

Resi
`Map<String, List<String>>`	La mappa dei test rilevati o null se non supportati o non riusciti.

discoverTests

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

Parametri
`context`	`IInvocationContext`
`configuration`	`IConfiguration`
`logger`	`ITestLogger`

Resi
`Map<String, List<String>>`

fetchSandboxExtraArtifacts

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

Sotto-passaggio di prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) che recupera i file aggiuntivi necessari per la sandbox.

Parametri
`context`	`IInvocationContext`: l'attuale chiamata `IInvocationContext`.
`configuration`	`IConfiguration`: il `IConfiguration` per il comando da eseguire.
`args`	`String`: gli argomenti della riga di comando.

Resi
`IFolderBuildInfo`	la build recuperata per i file sandbox aggiuntivi.

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

Restituisce l'ambiente sandbox TF da utilizzare in base agli argomenti della riga di comando.

Parametri
`context`	`IInvocationContext`: il `IInvocationContext` del genitore.
`nonVersionedConfig`	`IConfiguration`: il `IConfiguration` che rappresenta gli oggetti senza controllo delle versioni.
`args`	`String`: gli argomenti della riga di comando.

Resi
`File`	una directory `File` contenente i file JAR dell'ambiente sandbox TF.

Genera
`Exception`

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`

prepareEnvironment

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

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

Parametri
`context`	`IInvocationContext`: l'attuale chiamata `IInvocationContext`.
`configuration`	`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.

run

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

Esegui la sandbox con l'ambiente impostato.

Parametri
`info`	`TestInformation`: il `TestInformation` che descrive la chiamata
`configuration`	`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 abstract void tearDown ()

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