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.

IConfigurationFactory

public interface IConfigurationFactory

com.android.tradefed.config.IConfigurationFactory

Sottoclassi indirette note

ConfigurationFactory, GCSConfigurationFactory, RetryConfigurationFactory, SandboxConfigurationFactory

ConfigurationFactory	Factory per la creazione di `IConfiguration`.
GCSConfigurationFactory	Un `ConfigurationFactory` carica le configurazioni da Google Cloud Storage.
RetryConfigurationFactory	Factory che gestisce i tentativi di ripetizione di un comando.
SandboxConfigurationFactory	Fabbrica di configurazioni speciali per gestire la creazione di configurazioni a scopo di sandboxing.

Factory per la creazione di IConfiguration

Riepilogo

Metodi pubblici
`abstract IConfiguration`	`createConfigurationFromArgs(String[] args, List<String> unconsumedArgs, IKeyStoreClient keyStoreClient)` Crea `IConfiguration` dagli argomenti della riga di comando con un keystore.
`abstract IConfiguration`	`createConfigurationFromArgs(String[] args, List<String> unconsumedArgs)` Crea `IConfiguration` dagli argomenti della riga di comando.
`abstract IConfiguration`	`createConfigurationFromArgs(String[] args)` Un metodo pratico che chiama `createConfigurationFromArgs(String[],List)` con un secondo argomento `null`.
`abstract IGlobalConfiguration`	`createGlobalConfigurationFromArgs(String[] args, List<String> nonGlobalArgs)` Crea un `IGlobalConfiguration` dagli argomenti della riga di comando.
`abstract IConfiguration`	`createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient, Set<String> allowedObjects, TradefedDelegator delegator)` Crea una configurazione che contenga solo un insieme di oggetti selezionati.
`abstract void`	`dumpConfig(String configName, PrintStream out)` Scarica i contenuti della configurazione nel file `PrintStream` specificato
`abstract List<String>`	`getConfigList()` Restituisce l'elenco dei nomi di tutte le configurazioni trovate nei file JAR nel classpath.
`abstract List<String>`	`getConfigList(String subPath, boolean loadFromEnv)` Variante di `getConfigList()` in cui è possibile specificare se caricare o meno la configurazione dall'ambiente.
`abstract void`	`printHelp(PrintStream out)` Stampa l'output di assistenza per questa fabbrica.
`abstract void`	`printHelpForConfig(String[] args, boolean importantOnly, PrintStream out)` Stampa l'output della guida per `IConfiguration` specificato negli argomenti della riga di comando. Se "args" si riferisce a una configurazione nota, verrà creato un oggetto `IConfiguration` da XML e verrà visualizzata la guida per `IConfiguration`.

Metodi pubblici

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args, 
                List<String> unconsumedArgs, 
                IKeyStoreClient keyStoreClient)

Crea IConfiguration dagli argomenti della riga di comando con un keystore.

Il formato previsto è "CONFIG [options]", dove CONFIG è il nome della configurazione integrata o un percorso file a un file XML di configurazione.

Parametri
`args`	`String`: gli argomenti della riga di comando
`unconsumedArgs`	`List`: un elenco che verrà compilato con gli argomenti non utilizzati dagli oggetti associati alla configurazione specificata. Se questo è `null`, l'implementazione genererà `ConfigurationException` se rimangono argomenti non elaborati.
`keyStoreClient`	`IKeyStoreClient`: un `IKeyStoreClient` utilizzato per ottenere informazioni sensibili negli argomenti.

Resi
`IConfiguration`	il `IConfiguration` caricato. I campi dell'oggetto delegato `Option` sono stati compilati con i valori in args.

Genera
`ConfigurationException`	se non è stato possibile caricare la configurazione

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args, 
                List<String> unconsumedArgs)

Crea IConfiguration dagli argomenti della riga di comando.

Il formato previsto è "CONFIG [options]", dove CONFIG è il nome della configurazione integrata o un percorso file a un file XML di configurazione.

Parametri
`args`	`String`: gli argomenti della riga di comando
`unconsumedArgs`	`List`: un elenco che verrà compilato con gli argomenti non utilizzati dagli oggetti associati alla configurazione specificata. Se questo è `null`, l'implementazione genererà `ConfigurationException` se rimangono argomenti non elaborati.

Resi
`IConfiguration`	il `IConfiguration` caricato. I campi dell'oggetto delegato `Option` sono stati compilati con i valori in args.

Genera
`ConfigurationException`	se non è stato possibile caricare la configurazione

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args)

Un metodo pratico che chiama createConfigurationFromArgs(String[],List) con un secondo argomento null. Pertanto, genererà ConfigurationException se rimangono argomenti non utilizzati.

Parametri
`args`	`String`

Resi
`IConfiguration`

Genera
`ConfigurationException`

Vedi anche:

createConfigurationFromArgs(String[],List)

createGlobalConfigurationFromArgs

public abstract IGlobalConfiguration createGlobalConfigurationFromArgs (String[] args, 
                List<String> nonGlobalArgs)

Crea un IGlobalConfiguration dagli argomenti della riga di comando.

Il formato previsto è "CONFIG [options]", dove CONFIG è il nome della configurazione integrata o un percorso file a un file XML di configurazione.

Parametri
`args`	`String`: gli argomenti della riga di comando
`nonGlobalArgs`	`List`: un elenco che verrà compilato con gli argomenti che non sono stati elaborati come argomenti globali

Resi
`IGlobalConfiguration`	il `IGlobalConfiguration` caricato. I campi dell'oggetto delegato `Option` sono stati compilati con i valori in args.

Genera
`ConfigurationException`	se non è stato possibile caricare la configurazione

createPartialConfigurationFromArgs

public abstract IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, 
                IKeyStoreClient keyStoreClient, 
                Set<String> allowedObjects, 
                TradefedDelegator delegator)

Crea una configurazione che contenga solo un insieme di oggetti selezionati.

Parametri
`arrayArgs`	`String`: Gli argomenti della riga di comando
`keyStoreClient`	`IKeyStoreClient`: un `IKeyStoreClient` utilizzato per ottenere informazioni sensibili negli argomenti.
`allowedObjects`	`Set`: L'insieme di oggetti consentiti da creare
`delegator`	`TradefedDelegator`

Resi
`IConfiguration`	`IConfiguration` caricato.

Genera
`ConfigurationException`	se non è stato possibile caricare la configurazione

dumpConfig

public abstract void dumpConfig (String configName, 
                PrintStream out)

Scarica i contenuti della configurazione nel file PrintStream specificato

Parametri
`configName`	`String`: il nome della configurazione
`out`	`PrintStream`: il `PrintStream` in cui eseguire il dump dell'output

getConfigList

public abstract List<String> getConfigList ()

Restituisce l'elenco dei nomi di tutte le configurazioni trovate nei file JAR nel classpath. Non tenta di caricare nessuna delle configurazioni, quindi è possibile che in questo elenco siano presenti configurazioni non funzionanti.

Resi
`List<String>`

getConfigList

public abstract List<String> getConfigList (String subPath, 
                boolean loadFromEnv)

Variante di getConfigList() in cui è possibile specificare se caricare o meno la configurazione dall'ambiente.

Parametri
`subPath`	`String`: il nome delle sottodirectory in cui cercare la configurazione. Se è nullo, avrà lo stesso comportamento di `getConfigList()`.
`loadFromEnv`	`boolean`: True se dobbiamo caricare la configurazione nella variabile di ambiente.

Resi
`List<String>`

printHelp

public abstract void printHelp (PrintStream out)

Stampa l'output di assistenza per questa fabbrica.

Stampa informazioni della guida generiche ed elenca tutte le configurazioni disponibili.

Parametri
`out`	`PrintStream`: il `PrintStream` in cui eseguire il dump dell'output

printHelpForConfig

public abstract void printHelpForConfig (String[] args, 
                boolean importantOnly, 
                PrintStream out)

Stampa l'output della guida per IConfiguration specificato negli argomenti della riga di comando.

Se "args" si riferisce a una configurazione nota, verrà creato un oggetto IConfiguration da XML e verrà visualizzata la guida per IConfiguration. Tutti gli altri valori "args" verranno ignorati (ovvero il testo della guida descriverà i valori correnti di Option caricati da XML e non rifletterà i valori dell'opzione impostati dagli argomenti della riga di comando.

Se "args" non fa riferimento a un IConfiguration noto, verrà visualizzata la guida generica printHelp(PrintStream).

Parametri
`args`	`String`: gli argomenti della riga di comando
`importantOnly`	`boolean`: se `true`, stampa un elenco della guida abbreviato con solo i dettagli importanti
`out`	`PrintStream`: il `PrintStream` in cui eseguire il dump dell'output