GlobalConfiguration

public class GlobalConfiguration
extends Object implements IGlobalConfiguration

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

---

Uma implementação de IGlobalConfiguration que armazena os objetos de configuração carregados em um mapa

Resumo

Constantes
String	CREDENTIAL_FACTORY_TYPE_NAME
String	DEVICE_MANAGER_TYPE_NAME
String	DEVICE_MONITOR_TYPE_NAME
String	DEVICE_REQUIREMENTS_TYPE_NAME
String	GLOBAL_CONFIG_SERVER
String	GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE
String	GLOBAL_CONFIG_VARIABLE
String	HOST_MONITOR_TYPE_NAME
String	HOST_OPTIONS_TYPE_NAME
String	HOST_RESOURCE_MANAGER_TYPE_NAME
String	KEY_STORE_TYPE_NAME
String	MULTI_DEVICE_RECOVERY_TYPE_NAME
String	RESOURCE_METRIC_COLLECTOR_TYPE_NAME
String	SANDBOX_FACTORY_TYPE_NAME
String	SCHEDULER_TYPE_NAME
String	SHARDING_STRATEGY_TYPE_NAME
String	TF_DEVICE_MANAGEMENT_SERVER_NAME
String	TF_FEATURE_SERVER_NAME
String	TF_INVOCATION_SERVER_NAME
String	WTF_HANDLER_TYPE_NAME

Métodos públicos
void	cleanup() Limpeza adequada quando o tradefed é encerrado.
File	cloneConfigWithFilter( exclusionPatterns, String... allowlistConfigs) Filtre o GlobalConfiguration com base em uma lista de permissões e gere um arquivo XML.
File	cloneConfigWithFilter( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) Filtre o GlobalConfiguration com base em uma lista de permissões, permitindo a manipulação de valores de opção e a saída para um arquivo XML.
File	cloneConfigWithFilter(String... allowlistConfigs) Filtre o GlobalConfiguration com base em uma lista permitida e gere um arquivo XML.
static	createGlobalConfiguration(String[] args) Configura o singleton GlobalConfiguration para esta instância do TF.
ICommandScheduler	getCommandScheduler() Recebe o ICommandScheduler a ser usado na configuração.
Object	getConfigurationObject(String typeName) Recebe o objeto de configuração personalizada com o nome especificado.
ICredentialFactory	getCredentialFactory() Recebe o ICredentialFactory para criar credenciais.
String	getDescription()
DeviceManagementGrpcServer	getDeviceManagementServer() Retorna o DeviceManagementGrpcServer ou nulo se não estiver definido.
IDeviceManager	getDeviceManager() Recebe o IDeviceManager a ser usado na configuração.
static IDeviceManager	getDeviceManagerInstance() Retorna uma referência à instância singleton DeviceManager para esta instância do TF.
	getDeviceMonitors() Recebe a lista de IDeviceMonitor da configuração global.
IDeviceSelection	getDeviceRequirements() Recebe o IDeviceSelection a ser usado na configuração.
TradefedFeatureServer	getFeatureServer() Retorna o TradefedFeatureServer ou nulo se não estiver definido.
IConfigurationServer	getGlobalConfigServer() Recebe o servidor de configuração global.
static	getHostMonitorInstances()
	getHostMonitors() Recebe a lista de IHostMonitor da configuração global.
IHostOptions	getHostOptions() Recebe o IHostOptions a ser usado na configuração.
IHostResourceManager	getHostResourceManager() Recebe o IHostResourceManager da configuração global.
static IGlobalConfiguration	getInstance() Retorna uma referência à instância singleton GlobalConfiguration para esta instância do TF.
IKeyStoreFactory	getKeyStoreFactory() Recebe o IKeyStoreFactory a ser usado na configuração.
	getMultiDeviceRecoveryHandlers() Recebe a lista de IMultiDeviceRecovery a serem usadas na configuração.
String	getName()
	getOptionValues(String optionName) Recebe uma lista de valores de opção.
	getResourceMetricCollectors() Recebe a lista de IResourceMetricCollector da configuração global.
ISandboxFactory	getSandboxFactory() Receber uma fábrica de sandbox que pode ser usada para executar uma invocação
IShardHelper	getShardingStrategy() Retorna o IShardHelper que define a maneira de fragmentar uma configuração.
TestInvocationManagementServer	getTestInvocationManagementSever() Retorna o TestInvocationManagementServer ou nulo se não estiver definido.
ITerribleFailureHandler	getWtfHandler() Recebe o ITerribleFailureHandler a ser usado na configuração.
void	injectOptionValue(String optionName, String optionValue) Injeta um valor de opção no conjunto de objetos de configuração.
void	injectOptionValue(String optionName, String optionKey, String optionValue) Injeta um valor de opção no conjunto de objetos de configuração.
void	printCommandUsage(boolean importantOnly, PrintStream out) Gera um texto de ajuda de uso da linha de comando para essa configuração no printStream especificado.
void	setCommandScheduler(ICommandScheduler scheduler) Defina o ICommandScheduler, substituindo os valores atuais.
void	setConfigurationFactory(IConfigurationFactory configFactory) Defina o IConfigurationFactory para essa configuração.
void	setConfigurationObject(String typeName, Object configObject) Método genérico para definir o objeto de configuração com o nome especificado, 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 especificado, substituindo qualquer valor existente.
void	setDeviceManagementServer(DeviceManagementGrpcServer server) Define o DeviceManagementGrpcServer.
void	setDeviceManager(IDeviceManager manager) Defina o IDeviceManager, substituindo os valores atuais.
void	setDeviceMonitor(IDeviceMonitor monitor) Defina o IDeviceMonitor.
void	setDeviceRequirements(IDeviceSelection devRequirements) Defina o IDeviceSelection, substituindo os valores atuais.
void	setHostMonitors( hostMonitors) Defina a lista IHostMonitor.
void	setHostOptions(IHostOptions hostOptions) Defina o IHostOptions, substituindo os valores atuais.
void	setHostResourceManager(IHostResourceManager hostResourceManager) Defina o IHostResourceManager, substituindo os valores atuais.
void	setInvocationServer(TestInvocationManagementServer server) Define o TestInvocationManagementServer.
void	setKeyStoreFactory(IKeyStoreFactory factory) Defina o IKeyStoreFactory, substituindo os valores atuais.
	setOptionsFromCommandLineArgs( listArgs) Defina os campos de configuração global Option com o conjunto de argumentos de linha de comando especificado. Consulte ArgsOptionParser para saber o formato esperado.
void	setOriginalConfig(String config) Define a configuração original usada para criar a configuração global.
void	setResourceMetricCollector(IResourceMetricCollector collector) Define o IResourceMetricCollector.
void	setSandboxFactory(ISandboxFactory factory) Defina o ISandboxFactory, substituindo os valores atuais.
void	setShardingStrategy(IShardHelper sharding) Define o IShardHelper a ser usado ao fragmentar uma configuração.
void	setTradefedFeatureServer(TradefedFeatureServer server) Define o TradefedFeatureServer.
void	setWtfHandler(ITerribleFailureHandler wtfHandler) Defina o ITerribleFailureHandler.
void	setup() Configuração adequada no início do tradefed.
void	validateOptions() Valide os valores das opções.

Métodos protegidos
IConfigurationFactory	getConfigurationFactory()

Constantes

CREDENTIAL_FACTORY_TYPE_NAME

public static final String CREDENTIAL_FACTORY_TYPE_NAME

Valor da constante: "credential_factory"

DEVICE_MANAGER_TYPE_NAME

public static final String DEVICE_MANAGER_TYPE_NAME

Valor da constante: "device_manager"

DEVICE_MONITOR_TYPE_NAME

public static final String DEVICE_MONITOR_TYPE_NAME

Valor da constante: "device_monitor"

DEVICE_REQUIREMENTS_TYPE_NAME

public static final String DEVICE_REQUIREMENTS_TYPE_NAME

Valor da constante: "device_requirements"

GLOBAL_CONFIG_SERVER

public static final String GLOBAL_CONFIG_SERVER

Valor da constante: "global_config_server"

GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE

public static final String GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE

Valor da constante: "TF_GLOBAL_CONFIG_SERVER_CONFIG"

GLOBAL_CONFIG_VARIABLE

public static final String GLOBAL_CONFIG_VARIABLE

Valor da constante: "TF_GLOBAL_CONFIG"

HOST_MONITOR_TYPE_NAME

public static final String HOST_MONITOR_TYPE_NAME

Valor da constante: "host_monitor"

HOST_OPTIONS_TYPE_NAME

public static final String HOST_OPTIONS_TYPE_NAME

Valor da constante: "host_options"

HOST_RESOURCE_MANAGER_TYPE_NAME

public static final String HOST_RESOURCE_MANAGER_TYPE_NAME

Valor da constante: "host_resource_manager"

KEY_STORE_TYPE_NAME

public static final String KEY_STORE_TYPE_NAME

Valor da constante: "key_store"

MULTI_DEVICE_RECOVERY_TYPE_NAME

public static final String MULTI_DEVICE_RECOVERY_TYPE_NAME

Valor da constante: "multi_device_recovery"

RESOURCE_METRIC_COLLECTOR_TYPE_NAME

public static final String RESOURCE_METRIC_COLLECTOR_TYPE_NAME

Valor da constante: "resource_metric_collector"

SANDBOX_FACTORY_TYPE_NAME

public static final String SANDBOX_FACTORY_TYPE_NAME

Valor da constante: "sandbox_factory"

SCHEDULER_TYPE_NAME

public static final String SCHEDULER_TYPE_NAME

Valor da constante: "command_scheduler"

SHARDING_STRATEGY_TYPE_NAME

public static final String SHARDING_STRATEGY_TYPE_NAME

Valor da constante: "sharding_strategy"

TF_DEVICE_MANAGEMENT_SERVER_NAME

public static final String TF_DEVICE_MANAGEMENT_SERVER_NAME

Valor da constante: "tf_device_management_server"

TF_FEATURE_SERVER_NAME

public static final String TF_FEATURE_SERVER_NAME

Valor da constante: "tf_feature_server"

TF_INVOCATION_SERVER_NAME

public static final String TF_INVOCATION_SERVER_NAME

Valor da constante: "tf_invocation_server"

WTF_HANDLER_TYPE_NAME

public static final String WTF_HANDLER_TYPE_NAME

Valor da constante: "wtf_handler"

Métodos públicos

limpeza

public void cleanup ()

Limpeza adequada quando o tradefed é encerrado.

cloneConfigWithFilter

public File cloneConfigWithFilter ( exclusionPatterns, 
                String... allowlistConfigs)

Filtre o GlobalConfiguration com base em uma lista de permissões e gere um arquivo XML.

Parâmetros
exclusionPatterns	: o padrão de nome de classe a ser excluído do despejo.
allowlistConfigs	String: uma matriz String de configurações a serem incluídas no novo arquivo XML. Se estiver definido como null, a default list should be used.

Retorna
File	o arquivo que contém a nova configuração global filtrada.

cloneConfigWithFilter

public File cloneConfigWithFilter ( exclusionPatterns, 
                IConfigOptionValueTransformer transformer, 
                boolean deepCopy, 
                String... allowlistConfigs)

Filtre o GlobalConfiguration com base em uma lista de permissões, permitindo a manipulação de valores de opção e a saída para um arquivo XML.

Parâmetros
exclusionPatterns	: o padrão de nome de classe a ser excluído do despejo.
transformer	IConfigOptionValueTransformer
deepCopy	boolean
allowlistConfigs	String: uma matriz String de configurações a serem incluídas no novo arquivo XML. Se estiver definido como null, a default list should be used.

Retorna
File	o arquivo que contém a nova configuração global filtrada.

cloneConfigWithFilter

public File cloneConfigWithFilter (String... allowlistConfigs)

Filtre o GlobalConfiguration com base em uma lista permitida e gere um arquivo XML.

Por exemplo, para a seguinte configuração: <xml> <configuration> <device_monitor class="com.android.tradefed.device.DeviceMonitorMultiplexer" /> <wtf_handler class="com.android.tradefed.log.TerribleFailureEmailHandler" /> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

Todas as configurações, exceto "key_store", serão filtradas, resultando em um arquivo de configuração com o seguinte conteúdo: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

Parâmetros
allowlistConfigs	String: uma matriz String de configurações a serem incluídas no novo arquivo XML. Se estiver definido como null, a default list should be used.

Retorna
File	o arquivo que contém a nova configuração global filtrada.

createGlobalConfiguration

public static  createGlobalConfiguration (String[] args)

Configura o singleton GlobalConfiguration para esta instância do TF. Precisa ser chamado uma única vez, antes que qualquer coisa tente chamar getInstance()

Parâmetros
args	String

Retorna

Gera
IllegalStateException	se chamado mais de uma vez
ConfigurationException

getCommandScheduler

public ICommandScheduler getCommandScheduler ()

Recebe o ICommandScheduler a ser usado na configuração.

Retorna
ICommandScheduler	o ICommandScheduler. Nunca vai retornar nulo.

getConfigurationObject

public Object getConfigurationObject (String typeName)

Recebe o objeto de configuração personalizada com o nome especificado.

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

Retorna
Object	o objeto ou nulo se o objeto com esse nome não for encontrado

getCredentialFactory

public ICredentialFactory getCredentialFactory ()

Recebe o ICredentialFactory para criar credenciais.

Retorna
ICredentialFactory	ICredentialFactory ou null se nenhum for especificado.

getDescription

public String getDescription ()

Retorna
String	uma breve descrição legível pelo usuário deste Configuration

getDeviceManagementServer

public DeviceManagementGrpcServer getDeviceManagementServer ()

Retorna o DeviceManagementGrpcServer ou nulo se não estiver definido.

Retorna
DeviceManagementGrpcServer

getDeviceManager

public IDeviceManager getDeviceManager ()

Recebe o IDeviceManager a ser usado na configuração. Gerencia o conjunto de dispositivos disponíveis para teste.

Retorna
IDeviceManager	o IDeviceManager fornecido na configuração.

getDeviceManagerInstance

public static IDeviceManager getDeviceManagerInstance ()

Retorna uma referência à instância singleton DeviceManager para essa instância do TF.

Retorna
IDeviceManager

Gera
IllegalStateException	se createGlobalConfiguration(String[]) ainda não foi chamado.

getDeviceMonitors

public  getDeviceMonitors ()

Recebe a lista de IDeviceMonitor da configuração global.

Retorna
	a lista de IDeviceMonitor da configuração global ou null se nenhuma foi especificada.

getDeviceRequirements

public IDeviceSelection getDeviceRequirements ()

Recebe o IDeviceSelection a ser usado na configuração. Representa um filtro global em quais dispositivos o DeviceManager pode ver.

Retorna
IDeviceSelection	o IDeviceSelection fornecido na configuração.

getFeatureServer

public TradefedFeatureServer getFeatureServer ()

Retorna o TradefedFeatureServer ou nulo se não estiver definido.

Retorna
TradefedFeatureServer

getGlobalConfigServer

public IConfigurationServer getGlobalConfigServer ()

Recebe o servidor de configuração global. O servidor de configuração global é usado para receber configurações de host de um servidor em vez de arquivos locais.

Retorna
IConfigurationServer

getHostMonitorInstances

public static  getHostMonitorInstances ()

Retorna

getHostMonitors

public  getHostMonitors ()

Recebe a lista de IHostMonitor da configuração global.

Retorna
	a lista de IHostMonitor da configuração global ou null se nenhuma foi especificada.

getHostOptions

public IHostOptions getHostOptions ()

Recebe o IHostOptions a ser usado na configuração.

Retorna
IHostOptions	o IDeviceManager fornecido na configuração.

getHostResourceManager

public IHostResourceManager getHostResourceManager ()

Recebe o IHostResourceManager da configuração global.

Retorna
IHostResourceManager	o IHostResourceManager da configuração global ou a implementação padrão LocalHostResourceManager se nenhuma for especificada na configuração do host.

getInstance

public static IGlobalConfiguration getInstance ()

Retorna uma referência à instância singleton GlobalConfiguration para esta instância do TF.

Retorna
IGlobalConfiguration

Gera
IllegalStateException	se createGlobalConfiguration(String[]) ainda não foi chamado.

getKeyStoreFactory

public IKeyStoreFactory getKeyStoreFactory ()

Recebe o IKeyStoreFactory a ser usado na configuração.

Retorna
IKeyStoreFactory	o IKeyStoreFactory ou nulo se nenhuma fábrica de keystore estiver definida.

getMultiDeviceRecoveryHandlers

public  getMultiDeviceRecoveryHandlers ()

Recebe a lista de IMultiDeviceRecovery a serem usadas na configuração.

Retorna
	a lista de IMultiDeviceRecovery ou null se não estiver definida.

getName

public String getName ()

Retorna
String	o nome deste Configuration

getOptionValues

public  getOptionValues (String optionName)

Recebe uma lista de valores de opção.

Parâmetros
optionName	String: o nome da opção de mapa

Retorna
	uma lista dos valores da opção especificada. null se o nome da opção não existir.

getResourceMetricCollectors

public  getResourceMetricCollectors ()

Recebe a lista de IResourceMetricCollector da configuração global.

Retorna
	a lista de IResourceMetricCollector da configuração global ou null se nenhuma foi especificada.

getSandboxFactory

public ISandboxFactory getSandboxFactory ()

Receber uma fábrica de sandbox que pode ser usada para executar uma invocação

Retorna
ISandboxFactory

getShardingStrategy

public IShardHelper getShardingStrategy ()

Retorna o IShardHelper que define a maneira de fragmentar uma configuração.

Retorna
IShardHelper

getTestInvocationManagementSever

public TestInvocationManagementServer getTestInvocationManagementSever ()

Retorna o TestInvocationManagementServer ou nulo se não estiver definido.

Retorna
TestInvocationManagementServer

getWtfHandler

public ITerribleFailureHandler getWtfHandler ()

Recebe o ITerribleFailureHandler a ser usado na configuração. Processa o que fazer no caso de um WTF (What a Terrible Failure) ocorrer.

Retorna
ITerribleFailureHandler	o ITerribleFailureHandler fornecido na configuração ou nulo se nenhum manipulador estiver definido

injectOptionValue

public void injectOptionValue (String optionName, 
                String optionValue)

Injeta 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: os valores das opções.

Gera
ConfigurationException

injectOptionValue

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

Injeta 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 de mapa
optionKey	String: a chave da opção de mapa
optionValue	String: o valor da opção de mapa

Gera
ConfigurationException

printCommandUsage

public void printCommandUsage (boolean importantOnly, 
                PrintStream out)

Gera um texto de ajuda de uso da linha de comando para essa configuração no printStream especificado.

Parâmetros
importantOnly	boolean
out	PrintStream: o ERROR(/PrintStream) a ser usado.

Gera
	com.android.tradefed.config.ConfigurationException
ConfigurationException

setCommandScheduler

public void setCommandScheduler (ICommandScheduler scheduler)

Defina o ICommandScheduler, substituindo os valores atuais.

setConfigurationFactory

public void setConfigurationFactory (IConfigurationFactory configFactory)

Defina o IConfigurationFactory para essa configuração.

Parâmetros
configFactory	IConfigurationFactory

setConfigurationObject

public void setConfigurationObject (String typeName, 
                Object configObject)

Método genérico para definir o objeto de configuração com o nome especificado, 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 especificado, substituindo qualquer valor existente.

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

Gera
ConfigurationException

setDeviceManagementServer

public void setDeviceManagementServer (DeviceManagementGrpcServer server)

Define o DeviceManagementGrpcServer.

Parâmetros
server	DeviceManagementGrpcServer

setDeviceManager

public void setDeviceManager (IDeviceManager manager)

Defina o IDeviceManager, substituindo os valores atuais. Isso define o gerenciador para os dispositivos de teste.

setDeviceMonitor

public void setDeviceMonitor (IDeviceMonitor monitor)

Defina o IDeviceMonitor.

Parâmetros
monitor	IDeviceMonitor: o monitor

setDeviceRequirements

public void setDeviceRequirements (IDeviceSelection devRequirements)

Defina o IDeviceSelection, substituindo os valores atuais. Isso define um filtro global de dispositivos para determinar quais dispositivos o DeviceManager pode ver.

setHostMonitors

public void setHostMonitors ( hostMonitors)

Defina a lista IHostMonitor.

Parâmetros
hostMonitors	: a lista de monitores.

setHostOptions

public void setHostOptions (IHostOptions hostOptions)

Defina o IHostOptions, substituindo os valores atuais.

setHostResourceManager

public void setHostResourceManager (IHostResourceManager hostResourceManager)

Defina o IHostResourceManager, substituindo os valores atuais.

setInvocationServer

public void setInvocationServer (TestInvocationManagementServer server)

Define o TestInvocationManagementServer.

Parâmetros
server	TestInvocationManagementServer

setKeyStoreFactory

public void setKeyStoreFactory (IKeyStoreFactory factory)

Defina o IKeyStoreFactory, substituindo os valores atuais.

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs)

Defina os campos de configuração global Option com o conjunto de argumentos de linha de comando especificado.

Consulte ArgsOptionParser para saber o formato esperado.

Parâmetros
listArgs	: os argumentos da linha de comando

Retorna
	os argumentos não consumidos

Gera
ConfigurationException

setOriginalConfig

public void setOriginalConfig (String config)

Define a configuração original usada para criar a configuração global.

Parâmetros
config	String

setResourceMetricCollector

public void setResourceMetricCollector (IResourceMetricCollector collector)

Define o IResourceMetricCollector.

Parâmetros
collector	IResourceMetricCollector

setSandboxFactory

public void setSandboxFactory (ISandboxFactory factory)

Defina o ISandboxFactory, substituindo os valores atuais.

setShardingStrategy

public void setShardingStrategy (IShardHelper sharding)

Define o IShardHelper a ser usado ao fragmentar uma configuração.

Parâmetros
sharding	IShardHelper

setTradefedFeatureServer

public void setTradefedFeatureServer (TradefedFeatureServer server)

Define o TradefedFeatureServer.

Parâmetros
server	TradefedFeatureServer

setWtfHandler

public void setWtfHandler (ITerribleFailureHandler wtfHandler)

Defina o ITerribleFailureHandler.

Parâmetros
wtfHandler	ITerribleFailureHandler: o manipulador de WTF

configuração

public void setup ()

Configuração adequada no início do tradefed.

Gera
ConfigurationException

validateOptions

public void validateOptions ()

Valide os valores das opções.

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

Gera
ConfigurationException

Métodos protegidos

getConfigurationFactory

protected IConfigurationFactory getConfigurationFactory ()

Retorna
IConfigurationFactory