Configuración global

public class GlobalConfiguration
extends Object implements IGlobalConfiguration

java.lang.Objeto
com.android.tradefed.config.GlobalConfiguration


Una implementación IGlobalConfiguration que almacena los objetos de configuración cargados en un mapa

Resumen

Campos

public static final String CREDENTIAL_FACTORY_TYPE_NAME

public static final String DEVICE_MANAGER_TYPE_NAME

public static final String DEVICE_MONITOR_TYPE_NAME

public static final String DEVICE_REQUIREMENTS_TYPE_NAME

public static final String GLOBAL_CONFIG_SERVER

public static final String GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE

public static final String GLOBAL_CONFIG_VARIABLE

public static final String HOST_MONITOR_TYPE_NAME

public static final String HOST_OPTIONS_TYPE_NAME

public static final String HOST_RESOURCE_MANAGER_TYPE_NAME

public static final String KEY_STORE_TYPE_NAME

public static final String MULTI_DEVICE_RECOVERY_TYPE_NAME

public static final String RESOURCE_METRIC_COLLECTOR_TYPE_NAME

public static final String SANDBOX_FACTORY_TYPE_NAME

public static final String SCHEDULER_TYPE_NAME

public static final String SHARDING_STRATEGY_TYPE_NAME

public static final String TF_DEVICE_MANAGEMENT_SERVER_NAME

public static final String TF_FEATURE_SERVER_NAME

public static final String TF_INVOCATION_SERVER_NAME

public static final String WTF_HANDLER_TYPE_NAME

Métodos públicos

void cleanup ()

Limpieza adecuada cuando se apaga el comercio.

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

Filtre la configuración global según una lista blanca y envíela a un archivo XML.

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

Filtre la configuración global según una lista blanca y al mismo tiempo permita la manipulación de los valores de las opciones y la salida a un archivo XML.

File cloneConfigWithFilter (String... allowlistConfigs)

Filtre la configuración global según una lista permitida y envíela a un archivo XML.

static createGlobalConfiguration (String[] args)

Configura el singleton GlobalConfiguration para esta instancia de TF.

ICommandScheduler getCommandScheduler ()

Obtiene el ICommandScheduler que se utilizará desde la configuración.

Object getConfigurationObject (String typeName)

Obtiene el objeto de configuración personalizado con el nombre de pila.

ICredentialFactory getCredentialFactory ()

Obtiene ICredentialFactory para crear credenciales.

String getDescription ()
DeviceManagementGrpcServer getDeviceManagementServer ()

Devuelve DeviceManagementGrpcServer o nulo si no está definido.

IDeviceManager getDeviceManager ()

Obtiene el IDeviceManager que se utilizará desde la configuración.

static IDeviceManager getDeviceManagerInstance ()

Devuelve una referencia a la instancia única DeviceManager para esta instancia de TF.

getDeviceMonitors ()

Obtiene la lista de IDeviceMonitor de la configuración global.

IDeviceSelection getDeviceRequirements ()

Obtiene el IDeviceSelection que se utilizará desde la configuración.

TradefedFeatureServer getFeatureServer ()

Devuelve TradefedFeatureServer o nulo si no está definido.

IConfigurationServer getGlobalConfigServer ()

Obtiene el servidor de configuración global.

static getHostMonitorInstances ()
getHostMonitors ()

Obtiene la lista de IHostMonitor de la configuración global.

IHostOptions getHostOptions ()

Obtiene las IHostOptions que se utilizarán desde la configuración.

IHostResourceManager getHostResourceManager ()

Obtiene IHostResourceManager de la configuración global.

static IGlobalConfiguration getInstance ()

Devuelve una referencia a la instancia singleton GlobalConfiguration para esta instancia TF.

IKeyStoreFactory getKeyStoreFactory ()

Obtiene IKeyStoreFactory para usar desde la configuración.

getMultiDeviceRecoveryHandlers ()

Obtiene la lista de IMultiDeviceRecovery para usar desde la configuración.

String getName ()
getOptionValues (String optionName)

Obtenga una lista de los valores de las opciones.

getResourceMetricCollectors ()

Obtiene la lista de IResourceMetricCollector de la configuración global.

ISandboxFactory getSandboxFactory ()

Obtenga una fábrica de espacio aislado que pueda usarse para ejecutar una invocación

IShardHelper getShardingStrategy ()

Devuelve IShardHelper que define la forma de fragmentar una configuración.

TestInvocationManagementServer getTestInvocationManagementSever ()

Devuelve TestInvocationManagementServer o nulo si no está definido.

ITerribleFailureHandler getWtfHandler ()

Obtiene el ITerribleFailureHandler para usar desde la configuración.

void injectOptionValue (String optionName, String optionValue)

Inyecte un valor de opción en el conjunto de objetos de configuración.

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

Inyecte un valor de opción en el conjunto de objetos de configuración.

void printCommandUsage (boolean importantOnly, PrintStream out)

Genera un texto de ayuda sobre el uso de la línea de comandos para esta configuración en printStream determinado.

void setCommandScheduler ( ICommandScheduler scheduler)

Configure ICommandScheduler y reemplace los valores existentes.

void setConfigurationFactory ( IConfigurationFactory configFactory)

Establezca IConfigurationFactory para esta configuración.

void setConfigurationObject (String typeName, Object configObject)

Método genérico para configurar el objeto de configuración con el nombre dado, reemplazando cualquier valor existente.

void setConfigurationObjectList (String typeName, configList) setConfigurationObjectList (String typeName, configList)

Método genérico para establecer la lista de objetos de configuración para el nombre dado, reemplazando cualquier valor existente.

void setDeviceManagementServer ( DeviceManagementGrpcServer server)

Establece DeviceManagementGrpcServer .

void setDeviceManager ( IDeviceManager manager)

Configure IDeviceManager y reemplace los valores existentes.

void setDeviceMonitor ( IDeviceMonitor monitor)

Configure el IDeviceMonitor .

void setDeviceRequirements ( IDeviceSelection devRequirements)

Establezca IDeviceSelection y reemplace los valores existentes.

void setHostMonitors ( hostMonitors) setHostMonitors ( hostMonitors)

Configure la lista IHostMonitor .

void setHostOptions ( IHostOptions hostOptions)

Configure IHostOptions y reemplace los valores existentes.

void setHostResourceManager ( IHostResourceManager hostResourceManager)

Configure IHostResourceManager y reemplace los valores existentes.

void setInvocationServer ( TestInvocationManagementServer server)

Establece TestInvocationManagementServer .

void setKeyStoreFactory ( IKeyStoreFactory factory)

Configure IKeyStoreFactory y reemplace los valores existentes.

setOptionsFromCommandLineArgs ( listArgs) setOptionsFromCommandLineArgs ( listArgs)

Establezca los campos Option de configuración global con un conjunto dado de argumentos de línea de comando

Consulte ArgsOptionParser para conocer el formato esperado.

void setOriginalConfig (String config)

Establece la configuración original utilizada para crear la configuración global.

void setResourceMetricCollector ( IResourceMetricCollector collector)

Establece IResourceMetricCollector .

void setSandboxFactory ( ISandboxFactory factory)

Establezca ISandboxFactory y reemplace los valores existentes.

void setShardingStrategy ( IShardHelper sharding)

Establece IShardHelper que se utilizará al fragmentar una configuración.

void setTradefedFeatureServer ( TradefedFeatureServer server)

Establece TradefedFeatureServer .

void setWtfHandler ( ITerribleFailureHandler wtfHandler)

Configure ITerribleFailureHandler .

void setup ()

Configuración adecuada al inicio de tradefed.

void validateOptions ()

Validar los valores de las opciones.

Métodos protegidos

IConfigurationFactory getConfigurationFactory ()

Campos

CREDENTIAL_FACTORY_TYPE_NAME

public static final String CREDENTIAL_FACTORY_TYPE_NAME

DEVICE_MANAGER_TYPE_NAME

public static final String DEVICE_MANAGER_TYPE_NAME

DEVICE_MONITOR_TYPE_NAME

public static final String DEVICE_MONITOR_TYPE_NAME

DEVICE_REQUIREMENTS_TYPE_NAME

public static final String DEVICE_REQUIREMENTS_TYPE_NAME

GLOBAL_CONFIG_SERVER

public static final String GLOBAL_CONFIG_SERVER

GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE

public static final String GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE

GLOBAL_CONFIG_VARIABLE

public static final String GLOBAL_CONFIG_VARIABLE

HOST_MONITOR_TYPE_NAME

public static final String HOST_MONITOR_TYPE_NAME

HOST_OPTIONS_TYPE_NAME

public static final String HOST_OPTIONS_TYPE_NAME

HOST_RESOURCE_MANAGER_TYPE_NAME

public static final String HOST_RESOURCE_MANAGER_TYPE_NAME

KEY_STORE_TYPE_NAME

public static final String KEY_STORE_TYPE_NAME

MULTI_DEVICE_RECOVERY_TYPE_NAME

public static final String MULTI_DEVICE_RECOVERY_TYPE_NAME

RESOURCE_METRIC_COLLECTOR_TYPE_NAME

public static final String RESOURCE_METRIC_COLLECTOR_TYPE_NAME

SANDBOX_FACTORY_TYPE_NAME

public static final String SANDBOX_FACTORY_TYPE_NAME

SCHEDULER_TYPE_NAME

public static final String SCHEDULER_TYPE_NAME

SHARDING_STRATEGY_TYPE_NAME

public static final String SHARDING_STRATEGY_TYPE_NAME

TF_DEVICE_MANAGEMENT_SERVER_NAME

public static final String TF_DEVICE_MANAGEMENT_SERVER_NAME

TF_FEATURE_SERVER_NAME

public static final String TF_FEATURE_SERVER_NAME

TF_INVOCATION_SERVER_NAME

public static final String TF_INVOCATION_SERVER_NAME

WTF_HANDLER_TYPE_NAME

public static final String WTF_HANDLER_TYPE_NAME

Métodos públicos

limpiar

public void cleanup ()

Limpieza adecuada cuando se apaga el comercio.

cloneConfigWithFilter

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

Filtre la configuración global según una lista blanca y envíela a un archivo XML.

Parámetros
exclusionPatterns : El patrón del nombre de la clase que se excluirá del volcado.

allowlistConfigs String : una matriz String de configuraciones que se incluirán en el nuevo archivo XML. Si se establece en null , a default list should be used.
Devoluciones
File el archivo que contiene la nueva configuración global filtrada.

cloneConfigWithFilter

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

Filtre la configuración global según una lista blanca y al mismo tiempo permita la manipulación de los valores de las opciones y la salida a un archivo XML.

Parámetros
exclusionPatterns : El patrón del nombre de la clase que se excluirá del volcado.

transformer IConfigOptionValueTransformer

deepCopy boolean

allowlistConfigs String : una matriz String de configuraciones que se incluirán en el nuevo archivo XML. Si se establece en null , a default list should be used.
Devoluciones
File el archivo que contiene la nueva configuración global filtrada.

cloneConfigWithFilter

public File cloneConfigWithFilter (String... allowlistConfigs)

Filtre la configuración global según una lista permitida y envíela a un archivo XML.

Por ejemplo, para la siguiente configuración: <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 las configuraciones excepto "key_store" se filtrarán y el resultado será un archivo de configuración con el siguiente contenido: <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

Parámetros
allowlistConfigs String : una matriz String de configuraciones que se incluirán en el nuevo archivo XML. Si se establece en null , a default list should be used.
Devoluciones
File el archivo que contiene la nueva configuración global filtrada.

crear configuración global

public static  createGlobalConfiguration (String[] args)

Configura el singleton GlobalConfiguration para esta instancia de TF. Debe llamarse una vez y sólo una vez, antes de que algo intente llamar getInstance()

Parámetros
args String

Devoluciones

Lanza
IllegalStateException si te llaman más de una vez
ConfigurationException

obtenerCommandScheduler

public ICommandScheduler getCommandScheduler ()

Obtiene el ICommandScheduler que se utilizará desde la configuración.

Devoluciones
ICommandScheduler el ICommandScheduler . Nunca devolverá nulo.

obtener objeto de configuración

public Object getConfigurationObject (String typeName)

Obtiene el objeto de configuración personalizado con el nombre de pila.

Parámetros
typeName String : el tipo único del objeto de configuración.

Devoluciones
Object el objeto o nulo si no se encuentra el objeto con ese nombre

obtenerCredentialFactory

public ICredentialFactory getCredentialFactory ()

Obtiene ICredentialFactory para crear credenciales.

Devoluciones
ICredentialFactory ICredentialFactory o null si no se especificó ninguno.

obtener descripción

public String getDescription ()

Devoluciones
String una breve descripción legible por el usuario de esta Configuration

getDeviceManagementServer

public DeviceManagementGrpcServer getDeviceManagementServer ()

Devuelve DeviceManagementGrpcServer o nulo si no está definido.

Devoluciones
DeviceManagementGrpcServer

obtenerAdministrador de dispositivos

public IDeviceManager getDeviceManager ()

Obtiene el IDeviceManager que se utilizará desde la configuración. Gestiona el conjunto de dispositivos disponibles para realizar pruebas.

Devoluciones
IDeviceManager el IDeviceManager proporcionado en la configuración.

getDeviceManagerInstancia

public static IDeviceManager getDeviceManagerInstance ()

Devuelve una referencia a la instancia única DeviceManager para esta instancia de TF.

Devoluciones
IDeviceManager

Lanza
IllegalStateException si aún no se ha llamado createGlobalConfiguration(String[]) .

getDeviceMonitores

public  getDeviceMonitors ()

Obtiene la lista de IDeviceMonitor de la configuración global.

Devoluciones
la lista de IDeviceMonitor de la configuración global, o null si no se especificó ninguno.

obtener requisitos del dispositivo

public IDeviceSelection getDeviceRequirements ()

Obtiene el IDeviceSelection que se utilizará desde la configuración. Representa un filtro global sobre qué dispositivos puede ver el DeviceManager .

Devoluciones
IDeviceSelection el IDeviceSelection proporcionado en la configuración.

obtener servidor de funciones

public TradefedFeatureServer getFeatureServer ()

Devuelve TradefedFeatureServer o nulo si no está definido.

Devoluciones
TradefedFeatureServer

obtenerGlobalConfigServer

public IConfigurationServer getGlobalConfigServer ()

Obtiene el servidor de configuración global. El servidor de configuración global se utiliza para obtener configuraciones de host de un servidor en lugar de obtenerlas de archivos locales.

Devoluciones
IConfigurationServer

getHostMonitorInstancias

public static  getHostMonitorInstances ()

Devoluciones

getHostMonitores

public  getHostMonitors ()

Obtiene la lista de IHostMonitor de la configuración global.

Devoluciones
la lista de IHostMonitor de la configuración global, o null si no se especificó ninguno.

getHostOptions

public IHostOptions getHostOptions ()

Obtiene las IHostOptions que se utilizarán desde la configuración.

Devoluciones
IHostOptions el IDeviceManager proporcionado en la configuración.

obtenerHostResourceManager

public IHostResourceManager getHostResourceManager ()

Obtiene IHostResourceManager de la configuración global.

Devoluciones
IHostResourceManager el IHostResourceManager de la configuración global, o la implementación predeterminada LocalHostResourceManager si no se especifica ninguno en la configuración del host.

obtener Instancia

public static IGlobalConfiguration getInstance ()

Devuelve una referencia a la instancia singleton GlobalConfiguration para esta instancia TF.

Devoluciones
IGlobalConfiguration

Lanza
IllegalStateException si aún no se ha llamado createGlobalConfiguration(String[]) .

getKeyStoreFábrica

public IKeyStoreFactory getKeyStoreFactory ()

Obtiene IKeyStoreFactory para usar desde la configuración.

Devoluciones
IKeyStoreFactory IKeyStoreFactory o nulo si no se establece ninguna fábrica de almacén de claves.

getMultiDeviceRecoveryHandlers

public  getMultiDeviceRecoveryHandlers ()

Obtiene la lista de IMultiDeviceRecovery para usar desde la configuración.

Devoluciones
la lista de IMultiDeviceRecovery , o null si no está configurado.

obtenerNombre

public String getName ()

Devoluciones
String El nombre de esta Configuration

getOptionValues

public  getOptionValues (String optionName)

Obtenga una lista de los valores de las opciones.

Parámetros
optionName String : el nombre de la opción del mapa.

Devoluciones
una lista de los valores de la opción dada. null si el nombre de la opción no existe.

getResourceMetricCollectors

public  getResourceMetricCollectors ()

Obtiene la lista de IResourceMetricCollector de la configuración global.

Devoluciones
la lista de IResourceMetricCollector de la configuración global o null si no se especificó ninguno.

obtenerSandboxFactory

public ISandboxFactory getSandboxFactory ()

Obtenga una fábrica de espacio aislado que pueda usarse para ejecutar una invocación

Devoluciones
ISandboxFactory

getShardingStrategy

public IShardHelper getShardingStrategy ()

Devuelve IShardHelper que define la forma de fragmentar una configuración.

Devoluciones
IShardHelper

getTestInvocationManagementSever

public TestInvocationManagementServer getTestInvocationManagementSever ()

Devuelve TestInvocationManagementServer o nulo si no está definido.

Devoluciones
TestInvocationManagementServer

getWtfHandler

public ITerribleFailureHandler getWtfHandler ()

Obtiene el ITerribleFailureHandler para usar desde la configuración. Maneja qué hacer en caso de que ocurra un WTF (Qué terrible falla).

Devoluciones
ITerribleFailureHandler el ITerribleFailureHandler proporcionado en la configuración, o nulo si no se establece ningún controlador

inyectarValorOpción

public void injectOptionValue (String optionName, 
                String optionValue)

Inyecte un valor de opción en el conjunto de objetos de configuración.

Útil para proporcionar valores para opciones que se generan dinámicamente.

Parámetros
optionName String : el nombre de la opción

optionValue String : los valores de la opción

Lanza
ConfigurationException

inyectarValorOpción

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

Inyecte un valor de opción en el conjunto de objetos de configuración.

Útil para proporcionar valores para opciones que se generan dinámicamente.

Parámetros
optionName String : el nombre de la opción del mapa.

optionKey String : la clave de opción del mapa

optionValue String : el valor de la opción del mapa.

Lanza
ConfigurationException

imprimirComandoUso

public void printCommandUsage (boolean importantOnly, 
                PrintStream out)

Genera un texto de ayuda sobre el uso de la línea de comandos para esta configuración en printStream determinado.

Parámetros
importantOnly boolean

out PrintStream : el ERROR(/PrintStream) a utilizar.

Lanza
com.android.tradefed.config.ConfigurationException
ConfigurationException

establecerCommandScheduler

public void setCommandScheduler (ICommandScheduler scheduler)

Configure ICommandScheduler y reemplace los valores existentes.

setConfigurationFactory

public void setConfigurationFactory (IConfigurationFactory configFactory)

Establezca IConfigurationFactory para esta configuración.

Parámetros
configFactory IConfigurationFactory

establecerConfiguraciónObjeto

public void setConfigurationObject (String typeName, 
                Object configObject)

Método genérico para configurar el objeto de configuración con el nombre dado, reemplazando cualquier valor existente.

Parámetros
typeName String : el nombre único del tipo de objeto de configuración.

configObject Object : el objeto de configuración

Lanza
ConfigurationException

setConfigurationObjectList

public void setConfigurationObjectList (String typeName, 
                 configList)

Método genérico para establecer la lista de objetos de configuración para el nombre dado, reemplazando cualquier valor existente.

Parámetros
typeName String : el nombre único del tipo de objeto de configuración.

configList : la lista de objetos de configuración

Lanza
ConfigurationException

setDeviceManagementServer

public void setDeviceManagementServer (DeviceManagementGrpcServer server)

Establece DeviceManagementGrpcServer .

Parámetros
server DeviceManagementGrpcServer

establecerAdministrador de dispositivos

public void setDeviceManager (IDeviceManager manager)

Configure IDeviceManager y reemplace los valores existentes. Esto configura el administrador para los dispositivos de prueba.

establecerDeviceMonitor

public void setDeviceMonitor (IDeviceMonitor monitor)

Configure el IDeviceMonitor .

Parámetros
monitor IDeviceMonitor : El monitor

establecer requisitos del dispositivo

public void setDeviceRequirements (IDeviceSelection devRequirements)

Establezca IDeviceSelection y reemplace los valores existentes. Esto establece un filtro de dispositivo global sobre qué dispositivos puede ver el DeviceManager .

setHostMonitores

public void setHostMonitors ( hostMonitors)

Configure la lista IHostMonitor .

Parámetros
hostMonitors : La lista de monitores

establecer opciones de host

public void setHostOptions (IHostOptions hostOptions)

Configure IHostOptions y reemplace los valores existentes.

establecerHostResourceManager

public void setHostResourceManager (IHostResourceManager hostResourceManager)

Configure IHostResourceManager y reemplace los valores existentes.

establecer servidor de invocación

public void setInvocationServer (TestInvocationManagementServer server)

Establece TestInvocationManagementServer .

Parámetros
server TestInvocationManagementServer

setKeyStoreFábrica

public void setKeyStoreFactory (IKeyStoreFactory factory)

Configure IKeyStoreFactory y reemplace los valores existentes.

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs)

Establezca los campos Option de configuración global con un conjunto dado de argumentos de línea de comando

Consulte ArgsOptionParser para conocer el formato esperado.

Parámetros
listArgs : los argumentos de la línea de comando

Devoluciones
los argumentos no consumidos

Lanza
ConfigurationException

setOriginalConfig

public void setOriginalConfig (String config)

Establece la configuración original utilizada para crear la configuración global.

Parámetros
config String

setResourceMetricCollector

public void setResourceMetricCollector (IResourceMetricCollector collector)

Establece IResourceMetricCollector .

Parámetros
collector IResourceMetricCollector

setSandboxFactory

public void setSandboxFactory (ISandboxFactory factory)

Establezca ISandboxFactory y reemplace los valores existentes.

establecer estrategia de fragmentación

public void setShardingStrategy (IShardHelper sharding)

Establece IShardHelper que se utilizará al fragmentar una configuración.

Parámetros
sharding IShardHelper

setTradefedFeatureServer

public void setTradefedFeatureServer (TradefedFeatureServer server)

Establece TradefedFeatureServer .

Parámetros
server TradefedFeatureServer

setWtfHandler

public void setWtfHandler (ITerribleFailureHandler wtfHandler)

Configure ITerribleFailureHandler .

Parámetros
wtfHandler ITerribleFailureHandler : el controlador WTF

configuración

public void setup ()

Configuración adecuada al inicio de tradefed.

Lanza
ConfigurationException

validarOpciones

public void validateOptions ()

Validar los valores de las opciones.

Actualmente, esto solo validará que se hayan configurado todas las opciones obligatorias.

Lanza
ConfigurationException

Métodos protegidos

obtener configuración de fábrica

protected IConfigurationFactory getConfigurationFactory ()

Devoluciones
IConfigurationFactory