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ção

public class Configuration
extends Object implements IConfiguration

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

Uma implementação IConfiguration específica que armazena os objetos de configuração carregados em um mapa.

Resumo

Campos
`public static final String`	`BUILD_PROVIDER_TYPE_NAME`
`public static final String`	`CMD_OPTIONS_TYPE_NAME`
`public static final String`	`CONFIGURATION_DESCRIPTION_TYPE_NAME`
`public static final String`	`COVERAGE_OPTIONS_TYPE_NAME`
`public static final String`	`DEVICE_METRICS_COLLECTOR_TYPE_NAME`
`public static final String`	`DEVICE_NAME`
`public static final String`	`DEVICE_OPTIONS_TYPE_NAME`
`public static final String`	`DEVICE_RECOVERY_TYPE_NAME`
`public static final String`	`DEVICE_REQUIREMENTS_TYPE_NAME`
`public static final String`	`GLOBAL_FILTERS_TYPE_NAME`
`public static final String`	`LAB_PREPARER_TYPE_NAME`
`public static final String`	`LOGGER_TYPE_NAME`
`public static final String`	`LOG_SAVER_TYPE_NAME`
`public static final String`	`METRIC_POST_PROCESSOR_TYPE_NAME`
`public static final String`	`MULTI_PREPARER_TYPE_NAME`
`public static final String`	`MULTI_PRE_TARGET_PREPARER_TYPE_NAME`
`public static final`	`NON_MODULE_OBJECTS`
`public static final String`	`RESULT_REPORTER_TYPE_NAME`
`public static final String`	`RETRY_DECISION_TYPE_NAME`
`public static final String`	`SANBOX_OPTIONS_TYPE_NAME`
`public static final String`	`SANDBOX_TYPE_NAME`
`public static final String`	`SKIP_MANAGER_TYPE_NAME`
`public static final String`	`SYSTEM_STATUS_CHECKER_TYPE_NAME`
`public static final String`	`TARGET_PREPARER_TYPE_NAME`
`public static final String`	`TEST_TYPE_NAME`

Construtores públicos
`Configuration(String name, String description)` Cria um `Configuration` com objetos de configuração padrão.

Métodos públicos
`void`	`addFilesToClean( toBeCleaned)` Adicionar arquivos que precisam ser limpos durante o `cleanConfigurationData()`
`void`	`cleanConfigurationData()` Exclua todos os arquivos que foram transferidos para os campos de opção resolvidos de arquivos remotos.
`Configuration`	`clone()` Cria uma cópia superficial desse objeto.
`void`	`dumpXml(PrintWriter output)` Extrai o arquivo XML expandido da configuração com todas as opções mostradas para `IConfiguration` como `String`.
`void`	`dumpXml(PrintWriter output, excludeFilters)` Recebe o arquivo XML expandido da configuração com todas as opções mostradas para este `IConfiguration`, menos os filtros de objetos pelo nome da chave.
`void`	`dumpXml(PrintWriter output, excludeFilters, boolean printDeprecatedOptions, boolean printUnchangedOptions)` Recebe o arquivo XML expandido da configuração com todas as opções mostradas para este `IConfiguration`, menos os filtros de objetos pelo nome da chave.
	`getAllConfigurationObjectsOfType(String configType)` Interface genérica para receber todos os objetos de um determinado nome de tipo em todos os dispositivos.
`IBuildProvider`	`getBuildProvider()` Recebe o `IBuildProvider` da configuração.
`String`	`getCommandLine()` Recebe a linha de comando usada para criar esse `IConfiguration`.
`ICommandOptions`	`getCommandOptions()` Recebe a `ICommandOptions` a ser usada na configuração.
`ConfigurationDescriptor`	`getConfigurationDescription()` Retorna o `ConfigurationDescriptor` fornecido na configuração.
`Object`	`getConfigurationObject(String typeName)` Interface genérica para receber o objeto de configuração com o nome do tipo fornecido.
	`getConfigurationObjectList(String typeName)` Semelhante a `getConfigurationObject(String)`, mas para tipos de objetos de configuração que oferecem suporte a vários objetos.
`CoverageOptions`	`getCoverageOptions()` Recebe a `CoverageOptions` a ser usada na configuração.
`String`	`getDescription()`
	`getDeviceConfig()` Recebe os `IDeviceConfiguration`s da configuração.
`IDeviceConfiguration`	`getDeviceConfigByName(String nameDevice)` Retorna o `IDeviceConfiguration` associado ao nome fornecido ou nulo se não encontrado.
`TestDeviceOptions`	`getDeviceOptions()` Recebe a `TestDeviceOptions` a ser usada na configuração.
`IDeviceRecovery`	`getDeviceRecovery()` Recebe a `IDeviceRecovery` a ser usada na configuração.
`IDeviceSelection`	`getDeviceRequirements()` Recebe a `IDeviceSelection` a ser usada na configuração.
	`getFilesToClean()` Receber a lista de arquivos que serão limpos durante o `cleanConfigurationData()`
`GlobalTestFilter`	`getGlobalFilters()` Recebe o `GlobalTestFilter` para a invocação.
	`getInopOptions()` Conferir os nomes das opções que não mudaram os valores
	`getLabPreparers()` Recebe os `ITargetPreparer`s da configuração.
`ILeveledLogOutput`	`getLogOutput()` Recebe a `ILeveledLogOutput` a ser usada na configuração.
`ILogSaver`	`getLogSaver()` Recebe a `ILogSaver` a ser usada na configuração.
	`getMetricCollectors()` Recebe os `IMetricCollector`s da configuração.
`static`	`getMultiDeviceSupportedTag()` Retorna o `ERROR(/Set)` das tags com suporte em uma tag de dispositivo para configuração de vários dispositivos.
	`getMultiPreTargetPreparers()` Recebe os `IMultiTargetPreparer`s da configuração que precisa ser executada antes de qualquer um dos target_preparers dos dispositivos.
	`getMultiTargetPreparers()` Recebe os `IMultiTargetPreparer`s da configuração.
`String`	`getName()` Retorna o nome da configuração.
	`getPostProcessors()` Recebe os `IPostProcessor`s da configuração.
`IRetryDecision`	`getRetryDecision()` Retorna o `IRetryDecision` usado para a invocação.
`SkipManager`	`getSkipManager()` Recebe o `SkipManager` para a invocação.
	`getSystemStatusCheckers()` Recebe os `ISystemStatusChecker`s da configuração.
	`getTargetPreparers()` Recebe os `ITargetPreparer`s da configuração.
	`getTestInvocationListeners()` Recebe as `ITestInvocationListener`s a serem usadas na configuração.
	`getTests()` Recebe as `IRemoteTest`s para execução na configuração.
`void`	`injectOptionValue(String optionName, String optionValue)` Injete um valor de opção no conjunto de objetos de configuração.
`void`	`injectOptionValue(String optionName, String optionKey, String optionValue)` Injete um valor de opção no conjunto de objetos de configuração.
`void`	`injectOptionValueWithSource(String optionName, String optionKey, String optionValue, String source)` Injete um valor de opção no conjunto de objetos de configuração.
`void`	`injectOptionValues( optionDefs)` Injete vários valores de opção no conjunto de objetos de configuração.
`boolean`	`isDeviceConfiguredFake(String deviceName)` Retorna se um dispositivo configurado está marcado como isFake=true ou não.
`IConfiguration`	`partialDeepClone( objectToDeepClone, IKeyStoreClient client)` Crie um clone de base de `clone()` e clone em profundidade a lista do objeto de configuração fornecido.
`void`	`printCommandUsage(boolean importantOnly, PrintStream out)` Mostra um texto de ajuda de uso da linha de comando para essa configuração na printStream especificada.
`void`	`resolveDynamicOptions(DynamicRemoteFileResolver resolver)` Resolver opções de `ERROR(/File)` que apontam para um local remoto.
`void`	`safeInjectOptionValues( optionDefs)` Injete vários valores de opção no conjunto de objetos de configuração sem gerar uma exceção se uma das opções não puder ser aplicada.
	`setBestEffortOptionsFromCommandLineArgs( listArgs, IKeyStoreClient keyStoreClient)` Defina os campos `Option` de configuração com um conjunto específico de argumentos de linha de comando usando uma abordagem de esforço máximo.
`void`	`setBuildProvider(IBuildProvider provider)` Substitua o `IBuildProvider` atual na configuração.
`void`	`setCommandLine(String[] arrayArgs)` Define a linha de comando usada para criar esse `IConfiguration`.
`void`	`setCommandOptions(ICommandOptions cmdOptions)` Defina `ICommandOptions`, substituindo todos os valores atuais
`void`	`setConfigurationObject(String typeName, Object configObject)` Método genérico para definir o objeto de configuração com o nome fornecido, substituindo qualquer valor existente.
`void`	`setConfigurationObjectList(String typeName, configList)` Método genérico para definir a lista de objetos de configuração para o nome fornecido, substituindo qualquer valor atual.
`void`	`setCoverageOptions(CoverageOptions coverageOptions)` Defina `CoverageOptions`, substituindo todos os valores atuais.
`void`	`setDeviceConfig(IDeviceConfiguration deviceConfig)` Defina um `IDeviceConfiguration`, substituindo qualquer valor existente.
`void`	`setDeviceConfigList( deviceConfigs)` Defina os `IDeviceConfiguration`s, substituindo qualquer valor existente.
`void`	`setDeviceMetricCollectors( collectors)` Defina a lista de `IMetricCollector`s, substituindo todos os valores existentes.
`void`	`setDeviceOptions(TestDeviceOptions devOptions)` Defina `TestDeviceOptions`, substituindo todos os valores atuais
`void`	`setDeviceRecovery(IDeviceRecovery recovery)` Defina `IDeviceRecovery`, substituindo qualquer valor existente.
`void`	`setDeviceRequirements(IDeviceSelection devRequirements)` Defina `IDeviceSelection`, substituindo todos os valores atuais
`void`	`setLabPreparer(ITargetPreparer preparer)` Defina `ITargetPreparer`, substituindo qualquer valor existente.
`void`	`setLabPreparers( preparers)` Defina a lista de `ITargetPreparer`s, substituindo qualquer valor existente.
`void`	`setLogOutput(ILeveledLogOutput logger)` Defina `ILeveledLogOutput`, substituindo qualquer valor existente.
`void`	`setLogSaver(ILogSaver logSaver)` Defina `ILogSaver`, substituindo qualquer valor existente.
`void`	`setMultiPreTargetPreparer(IMultiTargetPreparer multiPreTargPrep)` Método de conveniência para definir um único `IMultiTargetPreparer` nessa configuração que precisa ser executado antes de qualquer um dos target_preparers dos dispositivos, substituindo os valores atuais
`void`	`setMultiPreTargetPreparers( multiPreTargPreps)` Define a lista de `IMultiTargetPreparer`s nesta configuração que precisam ser executadas antes de qualquer um dos target_preparers de dispositivos, substituindo todos os valores atuais
`void`	`setMultiTargetPreparer(IMultiTargetPreparer multiTargPrep)` Método de conveniência para definir um único `IMultiTargetPreparer` nessa configuração, substituindo todos os valores atuais
`void`	`setMultiTargetPreparers( multiTargPreps)` Define a lista de `IMultiTargetPreparer`s nessa configuração, substituindo todos os valores atuais
	`setOptionsFromCommandLineArgs( listArgs)` Definir os campos de configuração `Option` com um conjunto específico de argumentos de linha de comando `ArgsOptionParser` para o formato esperado
	`setOptionsFromCommandLineArgs( listArgs, IKeyStoreClient keyStoreClient)` Definir os campos de configuração `Option` com um conjunto específico de argumentos de linha de comando Consulte `ArgsOptionParser` para saber o formato esperado
`void`	`setPostProcessors( processors)` Defina a lista de `IPostProcessor`s, substituindo todos os valores existentes.
`void`	`setRetryDecision(IRetryDecision decisionRetry)` Defina `IRetryDecision`, substituindo qualquer valor existente.
`void`	`setSystemStatusChecker(ISystemStatusChecker systemChecker)` Método de conveniência para definir um único `ISystemStatusChecker` nessa configuração, substituindo todos os valores atuais
`void`	`setSystemStatusCheckers( systemCheckers)` Define a lista de `ISystemStatusChecker`s nessa configuração, substituindo todos os valores atuais
`void`	`setTargetPreparer(ITargetPreparer preparer)` Defina `ITargetPreparer`, substituindo qualquer valor existente.
`void`	`setTargetPreparers( preparers)` Defina a lista de `ITargetPreparer`s, substituindo qualquer valor existente.
`void`	`setTest(IRemoteTest test)` Método de conveniência para definir um único `IRemoteTest` nessa configuração, substituindo todos os valores atuais
`void`	`setTestInvocationListener(ITestInvocationListener listener)` Método de conveniência para definir um único `ITestInvocationListener`
`void`	`setTestInvocationListeners( listeners)` Definir a lista de `ITestInvocationListener`s, substituindo os valores atuais
`void`	`setTests( tests)` Define a lista de `IRemoteTest`s nessa configuração, substituindo todos os valores atuais
`void`	`validateOptions()` Valide os valores das opções.

Métodos protegidos
`boolean`	`isRemoteEnvironment()` Retorna se o ambiente do TF é uma invocação remota.

Campos

BUILD_PROVIDER_TYPE_NAME

public static final String BUILD_PROVIDER_TYPE_NAME

CMD_OPTIONS_TYPE_NAME

public static final String CMD_OPTIONS_TYPE_NAME

CONFIGURATION_DESCRIPTION_TYPE_NAME

public static final String CONFIGURATION_DESCRIPTION_TYPE_NAME

COVERAGE_OPTIONS_TYPE_NAME

public static final String COVERAGE_OPTIONS_TYPE_NAME

DEVICE_METRICS_COLLECTOR_TYPE_NAME

public static final String DEVICE_METRICS_COLLECTOR_TYPE_NAME

DEVICE_NAME

public static final String DEVICE_NAME

DEVICE_OPTIONS_TYPE_NAME

public static final String DEVICE_OPTIONS_TYPE_NAME

DEVICE_RECOVERY_TYPE_NAME

public static final String DEVICE_RECOVERY_TYPE_NAME

DEVICE_REQUIREMENTS_TYPE_NAME

public static final String DEVICE_REQUIREMENTS_TYPE_NAME

GLOBAL_FILTERS_TYPE_NAME

public static final String GLOBAL_FILTERS_TYPE_NAME

LAB_PREPARER_TYPE_NAME

public static final String LAB_PREPARER_TYPE_NAME

LOGGER_TYPE_NAME

public static final String LOGGER_TYPE_NAME

LOG_SAVER_TYPE_NAME

public static final String LOG_SAVER_TYPE_NAME

METRIC_POST_PROCESSOR_TYPE_NAME

public static final String METRIC_POST_PROCESSOR_TYPE_NAME

MULTI_PREPARER_TYPE_NAME

public static final String MULTI_PREPARER_TYPE_NAME

MULTI_PRE_TARGET_PREPARER_TYPE_NAME

public static final String MULTI_PRE_TARGET_PREPARER_TYPE_NAME

NON_MODULE_OBJECTS

public static final  NON_MODULE_OBJECTS

RESULT_REPORTER_TYPE_NAME

public static final String RESULT_REPORTER_TYPE_NAME

RETRY_DECISION_TYPE_NAME

public static final String RETRY_DECISION_TYPE_NAME

SANBOX_OPTIONS_TYPE_NAME

public static final String SANBOX_OPTIONS_TYPE_NAME

SANDBOX_TYPE_NAME

public static final String SANDBOX_TYPE_NAME

SKIP_MANAGER_TYPE_NAME

public static final String SKIP_MANAGER_TYPE_NAME

SYSTEM_STATUS_CHECKER_TYPE_NAME

public static final String SYSTEM_STATUS_CHECKER_TYPE_NAME

TARGET_PREPARER_TYPE_NAME

public static final String TARGET_PREPARER_TYPE_NAME

TEST_TYPE_NAME

public static final String TEST_TYPE_NAME

Construtores públicos

Configuração

public Configuration (String name, 
                String description)

Cria um Configuration com objetos de configuração padrão.

Parâmetros
`name`	`String`
`description`	`String`

Métodos públicos

addFilesToClean

public void addFilesToClean ( toBeCleaned)

Adicionar arquivos que precisam ser limpos durante o cleanConfigurationData()

Parâmetros
`toBeCleaned`

cleanConfigurationData

public void cleanConfigurationData ()

Exclua todos os arquivos que foram transferidos para os campos de opção resolvidos de arquivos remotos.

clone

public Configuration clone ()

Cria uma cópia superficial desse objeto.

Retorna
`Configuration`

dumpXml

public void dumpXml (PrintWriter output)

Extrai o arquivo XML expandido da configuração com todas as opções mostradas para IConfiguration como String.

Parâmetros
`output`	`PrintWriter`: o escritor para imprimir o XML.

dumpXml

public void dumpXml (PrintWriter output, 
                 excludeFilters)

Recebe o arquivo XML expandido da configuração com todas as opções mostradas para este IConfiguration, menos os filtros de objetos pelo nome da chave.

Exemplo de filtro: Configuration.TARGET_PREPARER_TYPE_NAME.

Parâmetros
`output`	`PrintWriter`: o escritor para imprimir o XML.
`excludeFilters`	: a lista de tipos de objetos que não devem ser descartados.

dumpXml

public void dumpXml (PrintWriter output, 
                 excludeFilters, 
                boolean printDeprecatedOptions, 
                boolean printUnchangedOptions)

Recebe o arquivo XML expandido da configuração com todas as opções mostradas para este IConfiguration, menos os filtros de objetos pelo nome da chave.

Exemplo de filtro: Configuration.TARGET_PREPARER_TYPE_NAME.

Parâmetros
`output`	`PrintWriter`: o escritor para imprimir o XML.
`excludeFilters`	: a lista de tipos de objetos que não devem ser despejados.
`printDeprecatedOptions`	`boolean`: se as opções marcadas como obsoletas serão impressas ou não
`printUnchangedOptions`	`boolean`

getAllConfigurationObjectsOfType

public  getAllConfigurationObjectsOfType (String configType)

Interface genérica para receber todos os objetos de um determinado tipo de nome em todos os dispositivos.

Parâmetros
`configType`	`String`: o tipo exclusivo do objeto de configuração

Retorna
	A lista de objetos de configuração do tipo especificado.

getBuildProvider

public IBuildProvider getBuildProvider ()

Recebe o IBuildProvider da configuração.

Retorna
`IBuildProvider`	o `IBuildProvider` fornecido na configuração

getCommandLine

public String getCommandLine ()

Extrai a linha de comando usada para criar esse IConfiguration.

Retorna
`String`	a linha de comando usada para criar esse `IConfiguration`.

getCommandOptions

public ICommandOptions getCommandOptions ()

Recebe a ICommandOptions a ser usada na configuração.

Retorna
`ICommandOptions`	o `ICommandOptions` fornecido na configuração.

getConfigurationDescription

public ConfigurationDescriptor getConfigurationDescription ()

Retorna o ConfigurationDescriptor fornecido na configuração.

Retorna
`ConfigurationDescriptor`

getConfigurationObject

public Object getConfigurationObject (String typeName)

Interface genérica para receber o objeto de configuração com o nome do tipo fornecido.

Parâmetros
`typeName`	`String`: o tipo exclusivo do objeto de configuração

Retorna
`Object`	o objeto de configuração ou `null`, se o tipo de objeto com o nome especificado não existir.

getConfigurationObjectList

public  getConfigurationObjectList (String typeName)

Semelhante a getConfigurationObject(String), mas para tipos de objetos de configuração que oferecem suporte a vários objetos.

Parâmetros
`typeName`	`String`: o nome de tipo exclusivo do objeto de configuração

Retorna
	a lista de objetos de configuração ou `null`, se o tipo de objeto com o nome especificado não existir.

getCoverageOptions

public CoverageOptions getCoverageOptions ()

Recebe a CoverageOptions a ser usada na configuração.

Retorna
`CoverageOptions`	o `CoverageOptions` fornecido na configuração.

getDescription

public String getDescription ()

Retorna
`String`	uma breve descrição legível para o usuário `Configuration`

getDeviceConfig

public  getDeviceConfig ()

Recebe os IDeviceConfigurations da configuração.

Retorna
	os `IDeviceConfiguration`s fornecidos em ordem na configuração

getDeviceConfigByName

public IDeviceConfiguration getDeviceConfigByName (String nameDevice)

Retorna o IDeviceConfiguration associado ao nome fornecido ou nulo se não encontrado.

Parâmetros
`nameDevice`	`String`

Retorna
`IDeviceConfiguration`

getDeviceOptions

public TestDeviceOptions getDeviceOptions ()

Recebe a TestDeviceOptions a ser usada na configuração.

Retorna
`TestDeviceOptions`	o `TestDeviceOptions` fornecido na configuração.

getDeviceRecovery

public IDeviceRecovery getDeviceRecovery ()

Recebe a IDeviceRecovery a ser usada na configuração.

Retorna
`IDeviceRecovery`	o `IDeviceRecovery` fornecido na configuração.

getDeviceRequirements

public IDeviceSelection getDeviceRequirements ()

Recebe a IDeviceSelection a ser usada na configuração.

Retorna
`IDeviceSelection`	o `IDeviceSelection` fornecido na configuração.

getFilesToClean

public  getFilesToClean ()

Receber a lista de arquivos que serão limpos durante o cleanConfigurationData()

Retorna

getGlobalFilters

public GlobalTestFilter getGlobalFilters ()

Recebe o GlobalTestFilter para a invocação.

Retorna
`GlobalTestFilter`

getInopOptions

public  getInopOptions ()

Conferir os nomes das opções que não mudaram os valores

Retorna

getLabPreparers

public  getLabPreparers ()

Recebe os ITargetPreparers da configuração.

Retorna
	os `ITargetPreparer`s fornecidos em ordem na configuração

getLogOutput

public ILeveledLogOutput getLogOutput ()

Recebe a ILeveledLogOutput a ser usada na configuração.

Retorna
`ILeveledLogOutput`	o `ILeveledLogOutput` fornecido na configuração.

getLogSaver

public ILogSaver getLogSaver ()

Recebe a ILogSaver a ser usada na configuração.

Retorna
`ILogSaver`	o `ILogSaver` fornecido na configuração.

getMetricCollectors

public  getMetricCollectors ()

Recebe os IMetricCollectors da configuração.

Retorna

getMultiDeviceSupportedTag

public static  getMultiDeviceSupportedTag ()

Retorna o ERROR(/Set) das tags com suporte em uma tag de dispositivo para configuração de vários dispositivos.

Retorna

getMultiPreTargetPreparers

public  getMultiPreTargetPreparers ()

Recebe os IMultiTargetPreparers da configuração que precisa ser executada antes de qualquer um dos target_preparers dos dispositivos.

Retorna
	os `IMultiTargetPreparer`s fornecidos em ordem na configuração

getMultiTargetPreparers

public  getMultiTargetPreparers ()

Recebe os IMultiTargetPreparers da configuração.

Retorna
	os `IMultiTargetPreparer`s fornecidos em ordem na configuração

getName

public String getName ()

Retorna o nome da configuração.

Retorna
`String`

getPostProcessors

public  getPostProcessors ()

Recebe os IPostProcessors da configuração.

Retorna

getRetryDecision

public IRetryDecision getRetryDecision ()

Retorna o IRetryDecision usado para a invocação.

Retorna
`IRetryDecision`

getSkipManager

public SkipManager getSkipManager ()

Recebe o SkipManager para a invocação.

Retorna
`SkipManager`

getSystemStatusCheckers

public  getSystemStatusCheckers ()

Recebe os ISystemStatusCheckers da configuração.

Retorna
	os `ISystemStatusChecker`s fornecidos em ordem na configuração

getTargetPreparers

public  getTargetPreparers ()

Recebe os ITargetPreparers da configuração.

Retorna
	os `ITargetPreparer`s fornecidos em ordem na configuração

getTestInvocationListeners

public  getTestInvocationListeners ()

Recebe os ITestInvocationListeners a serem usados na configuração.

Retorna
	os `ITestInvocationListener`s fornecidos na configuração.

getTests

public  getTests ()

Recebe as IRemoteTests para execução na configuração.

Retorna
	os testes fornecidos na configuração

injectOptionValue

public void injectOptionValue (String optionName, 
                String optionValue)

Injete um valor de opção no conjunto de objetos de configuração.

Útil para fornecer valores para opções geradas dinamicamente.

Parâmetros
`optionName`	`String`: o nome da opção
`optionValue`	`String`: o valor da opção

Gera
`ConfigurationException`

injectOptionValue

public void injectOptionValue (String optionName, 
                String optionKey, 
                String optionValue)

Injete um valor de opção no conjunto de objetos de configuração.

Útil para fornecer valores para opções geradas dinamicamente.

Parâmetros
`optionName`	`String`: o nome da opção
`optionKey`	`String`: a chave opcional para opções de mapa ou nulo
`optionValue`	`String`: o valor da opção de mapa

Gera
`ConfigurationException`

injectOptionValueWithSource

public void injectOptionValueWithSource (String optionName, 
                String optionKey, 
                String optionValue, 
                String source)

Injete um valor de opção no conjunto de objetos de configuração.

Útil para fornecer valores para opções geradas dinamicamente.

Parâmetros
`optionName`	`String`: o nome da opção
`optionKey`	`String`: a chave opcional para opções de mapa ou nulo
`optionValue`	`String`: o valor da opção de mapa
`source`	`String`: a configuração de origem que forneceu esse valor de opção

Gera
`ConfigurationException`

injectOptionValues

public void injectOptionValues ( optionDefs)

Injete vários valores de opção no conjunto de objetos de configuração.

Útil para injetar muitos valores de opção de uma só vez após a criação de um novo objeto.

Parâmetros
`optionDefs`	: uma lista de definições de opções a serem injetadas

Gera
`ConfigurationException`

isDeviceConfiguredFake

public boolean isDeviceConfiguredFake (String deviceName)

Retorna se um dispositivo configurado está marcado como isFake=true ou não.

Parâmetros
`deviceName`	`String`

Retorna
`boolean`

partialDeepClone

public IConfiguration partialDeepClone ( objectToDeepClone, 
                IKeyStoreClient client)

Crie um clone de base de clone() e clone em profundidade a lista do objeto de configuração fornecido.

Parâmetros
`objectToDeepClone`	: a lista de objetos de configuração a serem clonados em profundidade.
`client`	`IKeyStoreClient`: o cliente do keystore.

Retorna
`IConfiguration`	A configuração parcialmente clonada.

Gera
`ConfigurationException`

printCommandUsage

public void printCommandUsage (boolean importantOnly, 
                PrintStream out)

Mostra um texto de ajuda de uso da linha de comando para essa configuração na printStream especificada.

Parâmetros
`importantOnly`	`boolean`: se `true` mostrar apenas a ajuda para as opções importantes
`out`	`PrintStream`: o `ERROR(/PrintStream)` a ser usado.

Gera
	com.android.tradefed.config.ConfigurationException
`ConfigurationException`

resolveDynamicOptions

public void resolveDynamicOptions (DynamicRemoteFileResolver resolver)

Resolva as opções de ERROR(/File) que apontam para um local remoto. Isso exige que cleanConfigurationData() seja chamado para limpar os arquivos.

Parâmetros
`resolver`	`DynamicRemoteFileResolver`: o `DynamicRemoteFileResolver` para resolver os arquivos

Gera
`BuildRetrievalError`
`ConfigurationException`

safeInjectOptionValues

public void safeInjectOptionValues ( optionDefs)

Injete vários valores de opção no conjunto de objetos de configuração sem gerar uma exceção se uma das opções não puder ser aplicada.

Útil para injetar muitos valores de opção de uma só vez após a criação de um novo objeto.

Parâmetros
`optionDefs`	: uma lista de definições de opções a serem injetadas

Gera
`ConfigurationException`

setBestEffortOptionsFromCommandLineArgs

public  setBestEffortOptionsFromCommandLineArgs ( listArgs, 
                IKeyStoreClient keyStoreClient)

Defina os campos Option de configuração com um conjunto específico de argumentos de linha de comando usando uma abordagem de esforço máximo.

Consulte ArgsOptionParser para saber o formato esperado

Parâmetros
`listArgs`	: os argumentos da linha de comando
`keyStoreClient`	`IKeyStoreClient`: `IKeyStoreClient` a ser usado.

Retorna
	os argumentos não consumidos

Gera
`ConfigurationException`

setBuildProvider

public void setBuildProvider (IBuildProvider provider)

Substitua o IBuildProvider atual na configuração.

Parâmetros
`provider`	`IBuildProvider`: o novo `IBuildProvider`

setCommandLine

public void setCommandLine (String[] arrayArgs)

Define a linha de comando usada para criar esse IConfiguration. Isso armazena toda a linha de comando, incluindo o nome da configuração, diferente de setOptionsFromCommandLineArgs.

Parâmetros
`arrayArgs`	`String`: a linha de comando

setCommandOptions

public void setCommandOptions (ICommandOptions cmdOptions)

Defina ICommandOptions, substituindo todos os valores atuais

setConfigurationObject

public void setConfigurationObject (String typeName, 
                Object configObject)

Método genérico para definir o objeto de configuração com o nome fornecido, substituindo qualquer valor existente.

Parâmetros
`typeName`	`String`: o nome exclusivo do tipo de objeto de configuração.
`configObject`	`Object`: o objeto de configuração

Gera
`ConfigurationException`

setConfigurationObjectList

public void setConfigurationObjectList (String typeName, 
                 configList)

Método genérico para definir a lista de objetos de configuração para o nome fornecido, substituindo qualquer valor atual.

Parâmetros
`typeName`	`String`: o nome exclusivo do tipo de objeto de configuração.
`configList`	: a lista de objetos de configuração

Gera
`ConfigurationException`

setCoverageOptions

public void setCoverageOptions (CoverageOptions coverageOptions)

Defina CoverageOptions, substituindo todos os valores atuais.

Parâmetros
`coverageOptions`	`CoverageOptions`

setDeviceConfig

public void setDeviceConfig (IDeviceConfiguration deviceConfig)

Defina um IDeviceConfiguration, substituindo qualquer valor existente.

setDeviceConfigList

public void setDeviceConfigList ( deviceConfigs)

Defina os IDeviceConfigurations, substituindo qualquer valor existente.

setDeviceMetricCollectors

public void setDeviceMetricCollectors ( collectors)

Defina a lista de IMetricCollectors, substituindo todos os valores existentes.

Parâmetros
`collectors`

setDeviceOptions

public void setDeviceOptions (TestDeviceOptions devOptions)

Defina TestDeviceOptions, substituindo todos os valores atuais

Parâmetros
`devOptions`	`TestDeviceOptions`

setDeviceRecovery

public void setDeviceRecovery (IDeviceRecovery recovery)

Defina IDeviceRecovery, substituindo qualquer valor existente.

setDeviceRequirements

public void setDeviceRequirements (IDeviceSelection devRequirements)

Defina IDeviceSelection, substituindo todos os valores atuais

setLabPreparer

public void setLabPreparer (ITargetPreparer preparer)

Defina ITargetPreparer, substituindo qualquer valor existente.

setLabPreparers

public void setLabPreparers ( preparers)

Defina a lista de ITargetPreparers, substituindo qualquer valor existente.

setLogOutput

public void setLogOutput (ILeveledLogOutput logger)

Defina ILeveledLogOutput, substituindo qualquer valor existente.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Defina ILogSaver, substituindo qualquer valor existente.

setMultiPreTargetPreparer

public void setMultiPreTargetPreparer (IMultiTargetPreparer multiPreTargPrep)

Método de conveniência para definir um único IMultiTargetPreparer nessa configuração, que precisa ser executado antes de qualquer um dos target_preparers de dispositivos, substituindo os valores atuais

setMultiPreTargetPreparers

public void setMultiPreTargetPreparers ( multiPreTargPreps)

Define a lista de IMultiTargetPreparers nesta configuração que precisam ser executadas antes de qualquer um dos target_preparers de dispositivos, substituindo todos os valores atuais

setMultiTargetPreparer

public void setMultiTargetPreparer (IMultiTargetPreparer multiTargPrep)

Método de conveniência para definir um único IMultiTargetPreparer nessa configuração, substituindo todos os valores atuais

setMultiTargetPreparers

public void setMultiTargetPreparers ( multiTargPreps)

Define a lista de IMultiTargetPreparers nessa configuração, substituindo todos os valores atuais

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs)

Definir os campos de configuração Option com um conjunto específico de argumentos de linha de comando

ArgsOptionParser para o formato esperado

Parâmetros
`listArgs`	: os argumentos da linha de comando

Retorna
	os argumentos não consumidos

Gera
`ConfigurationException`

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs, 
                IKeyStoreClient keyStoreClient)

Definir os campos de configuração Option com um conjunto específico de argumentos de linha de comando

Consulte ArgsOptionParser para saber o formato esperado

Parâmetros
`listArgs`	: os argumentos da linha de comando
`keyStoreClient`	`IKeyStoreClient`: `IKeyStoreClient` a ser usado.

Retorna
	os argumentos não consumidos

Gera
`ConfigurationException`

setPostProcessors

public void setPostProcessors ( processors)

Defina a lista de IPostProcessors, substituindo todos os valores existentes.

Parâmetros
`processors`

setRetryDecision

public void setRetryDecision (IRetryDecision decisionRetry)

Defina IRetryDecision, substituindo qualquer valor existente.

setSystemStatusChecker

public void setSystemStatusChecker (ISystemStatusChecker systemChecker)

Método de conveniência para definir um único ISystemStatusChecker nessa configuração, substituindo todos os valores atuais

setSystemStatusCheckers

public void setSystemStatusCheckers ( systemCheckers)

Define a lista de ISystemStatusCheckers nessa configuração, substituindo todos os valores atuais

setTargetPreparer

public void setTargetPreparer (ITargetPreparer preparer)

Defina ITargetPreparer, substituindo qualquer valor existente.

setTargetPreparers

public void setTargetPreparers ( preparers)

Defina a lista de ITargetPreparers, substituindo qualquer valor existente.

setTest

public void setTest (IRemoteTest test)

Método de conveniência para definir um único IRemoteTest nessa configuração, substituindo todos os valores atuais

setTestInvocationListener

public void setTestInvocationListener (ITestInvocationListener listener)

Método de conveniência para definir um único ITestInvocationListener

setTestInvocationListeners

public void setTestInvocationListeners ( listeners)

Definir a lista de ITestInvocationListeners, substituindo os valores atuais

setTests

public void setTests ( tests)

Define a lista de IRemoteTests nessa configuração, substituindo todos os valores atuais

validateOptions

public void validateOptions ()

Valide os valores das opções.

No momento, isso apenas valida que todas as opções obrigatórias foram definidas.

Gera
`ConfigurationException`

Métodos protegidos

isRemoteEnvironment

protected boolean isRemoteEnvironment ()

Retorna se o ambiente do TF é uma invocação remota.

Retorna
`boolean`