A partire dal 2026, per allinearci al nostro modello di sviluppo stabile del trunk e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per la creazione e il contributo ad AOSP, consigliamo di utilizzare android-latest-release anziché aosp-main. Il ramo del manifest android-latest-release farà sempre riferimento alla release più recente inviata ad AOSP. Per saperne di più, vedi 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

Classi di sottoclasse indirette note

TradefedSandbox

TradefedSandbox Container sandbox che può eseguire un'invocazione della Federazione commerciale.

Interfaccia che definisce una sandbox che può essere utilizzata per eseguire un'invocazione.

Riepilogo

Metodi pubblici
`abstract String`	`createClasspath(File workingDir)` Crea un percorso di classe in base all'ambiente e alla directory di lavoro restituita da `getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.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 processo principale, torniamo al programma di avvio ridotto, dove tentiamo di configurare la sandbox con le informazioni attualmente conosciute e riempiamo la directory di lavoro per creare completamente la configurazione nella directory con versione.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Un sottopassaggio di `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` che rileva i test se `SandboxOptions.shouldUseTestDiscovery()` è attivato.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` Passaggio secondario di `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.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 percorso di classe in base all'ambiente e alla directory di lavoro restituita da getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]).

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

Ritorni
`String`	Il percorso del classpath da utilizzare.

Lanci
`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 processo principale, torniamo al programma di avvio ridotto, dove tentiamo di configurare la sandbox con le informazioni attualmente conosciute e riempiamo la directory di lavoro per creare completamente la configurazione nella directory con versione.

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

Ritorni
`IConfiguration`	Un file che rimanda al file XML di configurazione di TF per gli oggetti NON_VERSIONED. Restituisce null se non è stato possibile creare una configurazione del programma di avvio ridotto.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Un sottopassaggio di prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) che rileva i test se SandboxOptions.shouldUseTestDiscovery() è attivato.

Parametri
`context`	`IInvocationContext`: l'invocazione corrente `IInvocationContext`.
`configuration`	`IConfiguration`: il `IConfiguration` per il comando da eseguire.

Ritorni
	La mappa dei test rilevati o null se non supportati o non riusciti.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

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

Ritorni

fetchSandboxExtraArtifacts

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

Passaggio secondario di prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) che recupera i file aggiuntivi necessari per la sandbox.

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

Ritorni
`IFolderBuildInfo`	la compilazione recuperata per i file con sandbox aggiuntivi.

Lanci
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	IOException
`BuildRetrievalError`
`ConfigurationException`

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` dell'account principale.
`nonVersionedConfig`	`IConfiguration`: il `IConfiguration` che rappresenta gli oggetti non sottoposti al controllo delle versioni.
`args`	`String`: gli argomenti della riga di comando.

Ritorni
`File`	una directory `ERROR(/File)` contenente i file JAR dell'ambiente sandbox di TF.

getTradefedSandboxEnvironment

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

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

Ritorni
`File`

prepareEnvironment

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

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

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

Ritorni
`Exception`	un `Exception` contenente l'errore o Null se l'operazione è riuscita.

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 l'invocazione
`configuration`	`IConfiguration`: il `IConfiguration` per il comando da eseguire.
`logger`	`ITestLogger`: un `ITestLogger` in cui possiamo registrare i file.

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

tearDown

public abstract void tearDown ()

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