A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

ConfiguraçãoFábrica

public class ConfigurationFactory
extends Object implements IConfigurationFactory

java.lang.Object
↳	com.android.tradefed.config.ConfigurationFactory

Subclasses diretas conhecidas

GCSConfigurationFactory , RetryConfigurationFactory , SandboxConfigurationFactory

GCSConfiguraçãoFábrica	Um `ConfigurationFactory` carrega configurações do Google Cloud Storage.
Tentar novamenteConfiguraçãoFábrica	Fábrica que lida com a repetição de um comando.
SandboxConfiguraçãoFábrica	Fábrica de configuração especial para lidar com a criação de configurações para fins de sandbox.

Fábrica para criar IConfiguration .

Resumo

Classes aninhadas
`class`	`ConfigurationFactory.ConfigLoader` Implementação de IConfigDefLoader que rastreia as configurações incluídas de uma configuração raiz e lança uma exceção em inclusões circulares.
`class`	`ConfigurationFactory.ExceptionLoader`

Construtores protegidos
`ConfigurationFactory ()`

Métodos públicos
`void`	`clearMapConfig ()` Em algum caso particular, precisamos limpar o mapa.
`IConfiguration`	`createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs)` `createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs)` Crie o `IConfiguration` a partir de argumentos de linha de comando.
`IConfiguration`	`createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs, IKeyStoreClient keyStoreClient)` `createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs, IKeyStoreClient keyStoreClient)` Crie o `IConfiguration` a partir de argumentos de linha de comando com um armazenamento de chaves.
`IConfiguration`	`createConfigurationFromArgs (String[] arrayArgs)` Um método de conveniência que chama `ERROR(/#createConfigurationFromArgs(String[],List))` com um segundo argumento `null` .
`IGlobalConfiguration`	`createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs)` `createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs)` Crie um `IGlobalConfiguration` a partir de argumentos de linha de comando.
`IConfiguration`	`createPartialConfigurationFromArgs (String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator)` `createPartialConfigurationFromArgs (String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator)` Crie uma configuração que contenha apenas um conjunto de objetos selecionados.
`void`	`dumpConfig (String configName, PrintStream out)` Despeja o conteúdo da configuração para o `ERROR(/PrintStream)` fornecido
	`getConfigList (String subPath, boolean loadFromEnv)` Variação de `getConfigList()` onde podemos especificar se queremos ou não carregar também a configuração do ambiente.
	`getConfigList ()` Retorne a lista de nomes de todas as configurações encontradas nos JARs no classpath.
`static IConfigurationFactory`	`getInstance ()` Obtenha a instância singleton `IConfigurationFactory` .
`void`	`loadAllConfigs (boolean discardExceptions)` Carrega todas as configurações encontradas nos diretórios classpath e casos de teste.
`void`	`loadAndPrintAllConfigs ()` Método utilitário que verifica se todas as configurações podem ser carregadas, analisadas e todos os valores de opções definidos.
`void`	`printHelp (PrintStream out)` As impressões ajudam na saída desta fábrica.
`void`	`printHelpForConfig (String[] args, boolean importantOnly, PrintStream out)` Imprime a saída de ajuda para o `IConfiguration` especificado nos argumentos da linha de comando, Se 'args' se referir a uma configuração conhecida, um objeto `IConfiguration` será criado a partir de XML e a ajuda para esse `IConfiguration` será gerada.

Métodos protegidos
`InputStream`	`getBundledConfigStream (String name)`
`String`	`getConfigPrefix ()` Retorne o prefixo do caminho dos arquivos xml de configuração no caminho de classe Exposto para que os testes unitários possam simular.
`BufferedInputStream`	`getConfigStream (String name)` Carrega um InputStream para determinado nome de configuração
`ConfigurationDef`	`getConfigurationDef (String name, boolean isGlobal, templateMap)` `getConfigurationDef (String name, boolean isGlobal, templateMap)` Recuperar o `ConfigurationDef` para o nome fornecido
	`getMapConfig ()` Exposto para testes.
`boolean`	`isDirectConfiguration (String configName)`
`String[]`	`reorderArgs (String[] args)` Reordene os argumentos para que os argumentos template:map sejam todos movidos para a frente.
`IRemoteFileResolver.ResolvedFile`	`resolveRemoteFile (URI configURI, URI destDir)`

Construtores protegidos

ConfiguraçãoFábrica

protected ConfigurationFactory ()

Métodos públicos

clearMapConfig

public void clearMapConfig ()

Em algum caso particular, precisamos limpar o mapa.

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

Crie o IConfiguration a partir de argumentos de linha de comando.

O formato esperado é "CONFIG [opções]", onde CONFIG é o nome da configuração integrada ou um caminho de arquivo para um arquivo xml de configuração.

Parâmetros
`arrayArgs`	`String` : os argumentos da linha de comando
`unconsumedArgs`	: uma lista que será preenchida com os argumentos que não foram consumidos pelos objetos associados à configuração especificada. Se for `null` , a implementação lançará `ConfigurationException` se algum argumento não processado permanecer.

Devoluções
`IConfiguration`	o `IConfiguration` carregado. Os campos `Option` do objeto delegado foram preenchidos com valores em args.

Lança
`ConfigurationException`

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs, 
                IKeyStoreClient keyStoreClient)

Crie o IConfiguration a partir de argumentos de linha de comando com um armazenamento de chaves.

O formato esperado é "CONFIG [opções]", onde CONFIG é o nome da configuração integrada ou um caminho de arquivo para um arquivo xml de configuração.

Parâmetros
`arrayArgs`	`String` : os argumentos da linha de comando
`unconsumedArgs`	: uma lista que será preenchida com os argumentos que não foram consumidos pelos objetos associados à configuração especificada. Se for `null` , a implementação lançará `ConfigurationException` se algum argumento não processado permanecer.
`keyStoreClient`	`IKeyStoreClient` : um `IKeyStoreClient` que é usado para obter informações confidenciais nos argumentos.

Devoluções
`IConfiguration`	o `IConfiguration` carregado. Os campos `Option` do objeto delegado foram preenchidos com valores em args.

Lança
`ConfigurationException`

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

Um método de conveniência que chama ERROR(/#createConfigurationFromArgs(String[],List)) com um segundo argumento null . Assim, ele lançará ConfigurationException se restar algum argumento não consumido.

Parâmetros
`arrayArgs`	`String`

Devoluções
`IConfiguration`

Lança
`ConfigurationException`

createGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                 remainingArgs)

Crie um IGlobalConfiguration a partir de argumentos de linha de comando.

O formato esperado é "CONFIG [opções]", onde CONFIG é o nome da configuração integrada ou um caminho de arquivo para um arquivo xml de configuração.

Parâmetros
`arrayArgs`	`String` : os argumentos da linha de comando
`remainingArgs`	: uma lista que será preenchida com os argumentos que não foram processados como argumentos globais

Devoluções
`IGlobalConfiguration`	o `IGlobalConfiguration` carregado. Os campos `Option` do objeto delegado foram preenchidos com valores em args.

Lança
`ConfigurationException`

createPartialConfigurationFromArgs

public IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, 
                IKeyStoreClient keyStoreClient, 
                 allowedObjects, 
                TradefedDelegator delegator)

Crie uma configuração que contenha apenas um conjunto de objetos selecionados.

Parâmetros
`arrayArgs`	`String` : os argumentos da linha de comando
`keyStoreClient`	`IKeyStoreClient` : Um `IKeyStoreClient` que é usado para obter informações confidenciais nos argumentos.
`allowedObjects`	: O conjunto de objetos permitidos a serem criados
`delegator`	`TradefedDelegator`

Devoluções
`IConfiguration`	O `IConfiguration` carregado.

Lança
`ConfigurationException`

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

Despeja o conteúdo da configuração para o ERROR(/PrintStream) fornecido

Parâmetros
`configName`	`String` : o nome da configuração
`out`	`PrintStream` : o `ERROR(/PrintStream)` para despejar a saída para

getConfigList

public  getConfigList (String subPath, 
                boolean loadFromEnv)

Variação de getConfigList() onde podemos especificar se queremos ou não carregar também a configuração do ambiente.

Parâmetros
`subPath`	`String` : nome dos subdiretórios onde procurar a configuração. Se for nulo, terá o mesmo comportamento de `getConfigList()` .
`loadFromEnv`	`boolean` : True se devemos carregar a configuração na variável de ambiente.

Devoluções

getConfigList

public  getConfigList ()

Retorne a lista de nomes de todas as configurações encontradas nos JARs no classpath. Não tenta carregar nenhuma das configurações, então é possível ter configurações que não funcionam nesta lista.

Devoluções

getInstance

public static IConfigurationFactory getInstance ()

Obtenha a instância singleton IConfigurationFactory .

Devoluções
`IConfigurationFactory`

carregarAllConfigs

public void loadAllConfigs (boolean discardExceptions)

Carrega todas as configurações encontradas nos diretórios classpath e casos de teste.

Parâmetros
`discardExceptions`	`boolean` : verdadeiro se alguma ConfigurationException deve ser ignorada.

Lança
	com.android.tradefed.config.ConfigurationException
`ConfigurationException`

carregarAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

Método utilitário que verifica se todas as configurações podem ser carregadas, analisadas e todos os valores de opções definidos. Exposto apenas para que o projeto dependente possa validar suas configurações. Não deve ser exposto no console.

Lança
`ConfigurationException`	se uma ou mais configurações falharam ao carregar

imprimirAjuda

public void printHelp (PrintStream out)

As impressões ajudam na saída desta fábrica.

Imprime informações de ajuda genéricas e lista todas as configurações disponíveis.

Parâmetros
`out`	`PrintStream` : o `ERROR(/PrintStream)` para despejar a saída para

printHelpForConfig

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

Imprime a saída de ajuda para o IConfiguration especificado nos argumentos da linha de comando,

Se 'args' se referir a uma configuração conhecida, um objeto IConfiguration será criado a partir de XML e a ajuda para esse IConfiguration será gerada. Observe que todos os outros valores 'args' serão ignorados (ou seja, o texto de ajuda descreverá os valores atuais de Option s conforme carregados do XML e não refletirá os valores da opção definidos pelos argumentos da linha de comando.

Se 'args' não fizer referência a um IConfiguration conhecido, a ajuda genérica printHelp(PrintStream) será exibida.

Parâmetros
`args`	`String` : os argumentos da linha de comando
`importantOnly`	`boolean` : se `true` , imprime uma ajuda abreviada listando apenas os detalhes importantes
`out`	`PrintStream` : o `ERROR(/PrintStream)` para despejar a saída para

Métodos protegidos

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

Parâmetros
`name`	`String`

Devoluções
`InputStream`

getConfigPrefix

protected String getConfigPrefix ()

Retorne o prefixo do caminho dos arquivos xml de configuração no caminho de classe

Exposto para que os testes unitários possam simular.

Devoluções
`String`	Caminho `String` com / à direita

getConfigStream

protected BufferedInputStream getConfigStream (String name)

Carrega um InputStream para determinado nome de configuração

Parâmetros
`name`	`String` : o nome da configuração a ser carregada

Devoluções
`BufferedInputStream`	um `ERROR(/BufferedInputStream)` para ler o conteúdo da configuração

Lança
`ConfigurationException`	se a configuração não puder ser encontrada

getConfigurationDef

protected ConfigurationDef getConfigurationDef (String name, 
                boolean isGlobal, 
                 templateMap)

Recuperar o ConfigurationDef para o nome fornecido

Parâmetros
`name`	`String` : o nome de uma configuração interna a ser carregada ou um caminho de arquivo para o arquivo de configuração a ser carregado
`isGlobal`	`boolean`
`templateMap`

Devoluções
`ConfigurationDef`	`ConfigurationDef`

Lança
`ConfigurationException`	se ocorreu um erro ao carregar a configuração

getMapConfig

protected  getMapConfig ()

Exposto para testes. Devolva uma cópia do Mapa.

Devoluções

configuração isDirect

protected boolean isDirectConfiguration (String configName)

Parâmetros
`configName`	`String`

Devoluções
`boolean`

reordenarArgs

protected String[] reorderArgs (String[] args)

Reordene os argumentos para que os argumentos template:map sejam todos movidos para a frente.

Parâmetros
`args`	`String`

Devoluções
`String[]`

resolverRemoteFile

protected IRemoteFileResolver.ResolvedFile resolveRemoteFile (URI configURI, 
                URI destDir)

Parâmetros
`configURI`	`URI`
`destDir`	`URI`

Devoluções
`IRemoteFileResolver.ResolvedFile`

Lança
`BuildRetrievalError`

ConfiguraçãoFábrica

Resumo

Classes aninhadas

Construtores protegidos

Métodos públicos

Métodos protegidos

Construtores protegidos

ConfiguraçãoFábrica

Métodos públicos

clearMapConfig

createConfigurationFromArgs

createConfigurationFromArgs

createConfigurationFromArgs

createGlobalConfigurationFromArgs

createPartialConfigurationFromArgs

dumpConfig

getConfigList

getConfigList

getInstance

carregarAllConfigs

carregarAndPrintAllConfigs

imprimirAjuda

printHelpForConfig

Métodos protegidos

getBundledConfigStream

getConfigPrefix

getConfigStream

getConfigurationDef

getMapConfig

configuração isDirect

reordenarArgs

resolverRemoteFile