Configuración de IGlobal
public interface IGlobalConfiguration
com.android.tradefed.config.IGlobalConfiguration |
Una clase para abarcar información de configuración global para una única instancia de Trade Federation (que abarca cualquier número de invocaciones de configuraciones reales).
Resumen
Métodos públicos | |
---|---|
abstract void | cleanup () Limpieza adecuada cuando se apaga tradefed. |
abstract File | cloneConfigWithFilter ( exclusionPatterns, String... allowlistConfigs) cloneConfigWithFilter ( exclusionPatterns, String... allowlistConfigs) Filtre la configuración global en función de una lista blanca y envíela a un archivo XML. |
abstract File | cloneConfigWithFilter ( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) cloneConfigWithFilter ( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) Filtre la configuración global en función de una lista blanca mientras permite la manipulación de los valores de las opciones y la salida a un archivo XML. |
abstract File | cloneConfigWithFilter (String... allowlistConfigs) Filtre la configuración global en función de una lista permitida y envíela a un archivo XML. |
abstract ICommandScheduler | getCommandScheduler () Obtiene el |
abstract Object | getConfigurationObject (String typeName) Obtiene el objeto de configuración personalizado con el nombre dado. |
abstract ICredentialFactory | getCredentialFactory () Obtiene |
abstract DeviceManagementGrpcServer | getDeviceManagementServer () Devuelve |
abstract IDeviceManager | getDeviceManager () Obtiene el |
abstract | getDeviceMonitors () Obtiene la lista de |
abstract IDeviceSelection | getDeviceRequirements () Obtiene |
abstract TradefedFeatureServer | getFeatureServer () Devuelve |
abstract IConfigurationServer | getGlobalConfigServer () Obtiene el servidor de configuración global. |
abstract | getHostMonitors () Obtiene la lista de |
abstract IHostOptions | getHostOptions () Obtiene |
abstract IHostResourceManager | getHostResourceManager () Obtiene el |
abstract IKeyStoreFactory | getKeyStoreFactory () Obtiene |
abstract | getMultiDeviceRecoveryHandlers () Obtiene la lista de |
abstract | getOptionValues (String optionName) Obtenga una lista de los valores de las opciones. |
abstract | getResourceMetricCollectors () Obtiene la lista de |
abstract ISandboxFactory | getSandboxFactory () Obtenga una fábrica de sandbox que se puede usar para ejecutar una invocación |
abstract IShardHelper | getShardingStrategy () Devuelve el |
abstract TestInvocationManagementServer | getTestInvocationManagementSever () Devuelve |
abstract ITerribleFailureHandler | getWtfHandler () Obtiene el |
abstract void | injectOptionValue (String optionName, String optionValue) Inyecte un valor de opción en el conjunto de objetos de configuración. |
abstract void | injectOptionValue (String optionName, String optionKey, String optionValue) Inyecte un valor de opción en el conjunto de objetos de configuración. |
abstract void | setCommandScheduler ( ICommandScheduler scheduler) Configure el |
abstract void | setConfigurationFactory ( IConfigurationFactory configFactory) Establezca |
abstract void | setConfigurationObject (String name, Object configObject) Método genérico para establecer el objeto de configuración con el nombre dado, reemplazando cualquier valor existente. |
abstract 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. |
abstract void | setDeviceManagementServer ( DeviceManagementGrpcServer server) Establece |
abstract void | setDeviceManager ( IDeviceManager deviceManager) Configure el |
abstract void | setDeviceMonitor ( IDeviceMonitor deviceMonitor) Configure el |
abstract void | setDeviceRequirements ( IDeviceSelection deviceSelection) Establezca |
abstract void | setHostMonitors ( hostMonitors) setHostMonitors ( hostMonitors) Configure la lista |
abstract void | setHostOptions ( IHostOptions hostOptions) Establezca |
abstract void | setHostResourceManager ( IHostResourceManager hostResourceManager) Configure el |
abstract void | setInvocationServer ( TestInvocationManagementServer server) Establece |
abstract void | setKeyStoreFactory ( IKeyStoreFactory factory) Configure |
abstract | setOptionsFromCommandLineArgs ( listArgs) setOptionsFromCommandLineArgs ( listArgs) Establezca los campos ArgsOptionParser para el formato esperado |
abstract void | setOriginalConfig (String config) Establece la configuración original utilizada para crear la configuración global. |
abstract void | setResourceMetricCollector ( IResourceMetricCollector collector) Establece el |
abstract void | setSandboxFactory ( ISandboxFactory factory) Configure |
abstract void | setShardingStrategy ( IShardHelper sharding) Establece el |
abstract void | setTradefedFeatureServer ( TradefedFeatureServer server) Establece |
abstract void | setWtfHandler ( ITerribleFailureHandler wtfHandler) Configure el |
abstract void | setup () Configuración adecuada al comienzo de tradefed. |
abstract void | validateOptions () Validar valores de opciones. |
Métodos públicos
limpiar
public abstract void cleanup ()
Limpieza adecuada cuando se apaga tradefed.
clonConfigConFiltro
public abstract File cloneConfigWithFilter (exclusionPatterns, String... allowlistConfigs)
Filtre la configuración global en función de una lista blanca y envíela a un archivo XML.
Parámetros | |
---|---|
exclusionPatterns | |
allowlistConfigs | String : una matriz ERROR(/String) de configuraciones que se incluirán en el nuevo archivo XML. Si se establece en null |
Devoluciones | |
---|---|
File | el archivo que contiene la nueva configuración global filtrada. |
Lanza | |
---|---|
| IOException |
Ver también:
clonConfigConFiltro
public abstract File cloneConfigWithFilter (exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs)
Filtre la configuración global en función de una lista blanca mientras permite la manipulación de los valores de las opciones y la salida a un archivo XML.
Parámetros | |
---|---|
exclusionPatterns | |
transformer | IConfigOptionValueTransformer |
deepCopy | boolean |
allowlistConfigs | String : una matriz ERROR(/String) de configuraciones que se incluirán en el nuevo archivo XML. Si se establece en null |
Devoluciones | |
---|---|
File | el archivo que contiene la nueva configuración global filtrada. |
Ver también:
clonConfigConFiltro
public abstract File cloneConfigWithFilter (String... allowlistConfigs)
Filtre la configuración global en función de 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>
toda la configuración, excepto "key_store", se filtrará y dará como resultado 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 ERROR(/String) de configuraciones que se incluirán en el nuevo archivo XML. Si se establece en null |
Devoluciones | |
---|---|
File | el archivo que contiene la nueva configuración global filtrada. |
Lanza | |
---|---|
| IOException |
getCommandScheduler
public abstract ICommandScheduler getCommandScheduler ()
Obtiene el ICommandScheduler
para usar desde la configuración.
Devoluciones | |
---|---|
ICommandScheduler | el ICommandScheduler . Nunca devolverá nulo. |
getConfigurationObject
public abstract Object getConfigurationObject (String typeName)
Obtiene el objeto de configuración personalizado con el nombre dado.
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 |
getCredentialFactory
public abstract ICredentialFactory getCredentialFactory ()
Obtiene ICredentialFactory
para crear credenciales.
Devoluciones | |
---|---|
ICredentialFactory | ICredentialFactory o null si no se especificó ninguno. |
getDeviceManagementServer
public abstract DeviceManagementGrpcServer getDeviceManagementServer ()
Devuelve DeviceManagementGrpcServer
o nulo si no está definido.
Devoluciones | |
---|---|
DeviceManagementGrpcServer |
getDeviceManager
public abstract IDeviceManager getDeviceManager ()
Obtiene el IDeviceManager
para usar desde la configuración. Administra el conjunto de dispositivos disponibles para la prueba
Devoluciones | |
---|---|
IDeviceManager | el IDeviceManager proporcionado en la configuración. |
getDeviceMonitores
public abstractgetDeviceMonitors ()
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. |
getDeviceRequirements
public abstract IDeviceSelection getDeviceRequirements ()
Obtiene IDeviceSelection
para usar desde la configuración. Representa un filtro global en qué dispositivos puede ver DeviceManager
.
Devoluciones | |
---|---|
IDeviceSelection | la IDeviceSelection proporcionada en la configuración. |
getFeatureServer
public abstract TradefedFeatureServer getFeatureServer ()
Devuelve TradefedFeatureServer
o nulo si no está definido.
Devoluciones | |
---|---|
TradefedFeatureServer |
getGlobalConfigServer
public abstract IConfigurationServer getGlobalConfigServer ()
Obtiene el servidor de configuración global. El servidor de configuración global se usa para obtener configuraciones de host de un servidor en lugar de obtenerlas de archivos locales.
Devoluciones | |
---|---|
IConfigurationServer |
getHostMonitores
public abstractgetHostMonitors ()
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 abstract IHostOptions getHostOptions ()
Obtiene IHostOptions
para usar desde la configuración.
Devoluciones | |
---|---|
IHostOptions | el IDeviceManager proporcionado en la configuración. |
getHostResourceManager
public abstract IHostResourceManager getHostResourceManager ()
Obtiene el 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. |
getKeyStoreFactory
public abstract IKeyStoreFactory getKeyStoreFactory ()
Obtiene IKeyStoreFactory
para usar desde la configuración.
Devoluciones | |
---|---|
IKeyStoreFactory | IKeyStoreFactory o nulo si no se establece ninguna fábrica de almacenamiento de claves. |
getMultiDeviceRecoveryHandlers
public abstractgetMultiDeviceRecoveryHandlers ()
Obtiene la lista de IMultiDeviceRecovery
para usar desde la configuración.
Devoluciones | |
---|---|
la lista de IMultiDeviceRecovery , o null si no se establece. |
getOptionValues
public abstractgetOptionValues (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 abstractgetResourceMetricCollectors ()
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. |
getSandboxFactory
public abstract ISandboxFactory getSandboxFactory ()
Obtenga una fábrica de sandbox que se puede usar para ejecutar una invocación
Devoluciones | |
---|---|
ISandboxFactory |
getShardingStrategy
public abstract IShardHelper getShardingStrategy ()
Devuelve el IShardHelper
que define la forma de fragmentar una configuración.
Devoluciones | |
---|---|
IShardHelper |
getTestInvocationManagementSever
public abstract TestInvocationManagementServer getTestInvocationManagementSever ()
Devuelve TestInvocationManagementServer
o nulo si no está definido.
Devoluciones | |
---|---|
TestInvocationManagementServer |
obtenerWtfHandler
public abstract ITerribleFailureHandler getWtfHandler ()
Obtiene el ITerribleFailureHandler
para usar desde la configuración. Maneja qué hacer en caso de que ocurra un WTF (What a Terrible Failure).
Devoluciones | |
---|---|
ITerribleFailureHandler | el ITerribleFailureHandler proporcionado en la configuración, o nulo si no se establece ningún controlador |
inyectarValorOpción
public abstract 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 las 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 | si no pudo establecer el valor de la opción |
inyectarValorOpción
public abstract 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 las 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 de mapa |
optionValue | String : el valor de la opción del mapa |
Lanza | |
---|---|
ConfigurationException | si no pudo establecer el valor de la opción |
setCommandScheduler
public abstract void setCommandScheduler (ICommandScheduler scheduler)
Configure el ICommandScheduler
, reemplazando cualquier valor existente.
setConfigurationFactory
public abstract void setConfigurationFactory (IConfigurationFactory configFactory)
Establezca IConfigurationFactory
para esta configuración.
Parámetros | |
---|---|
configFactory | IConfigurationFactory |
setConfigurationObject
public abstract void setConfigurationObject (String name, Object configObject)
Método genérico para establecer el objeto de configuración con el nombre dado, reemplazando cualquier valor existente.
Parámetros | |
---|---|
name | String : el nombre único del tipo de objeto de configuración. |
configObject | Object : el objeto de configuración |
Lanza | |
---|---|
ConfigurationException | si el configObject no era del tipo correcto |
setConfigurationObjectListConfigurationObjectList
public abstract 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 |
Lanza | |
---|---|
ConfigurationException | si algún objeto de la lista no es del tipo correcto |
setDeviceManagementServer
public abstract void setDeviceManagementServer (DeviceManagementGrpcServer server)
Establece DeviceManagementGrpcServer
.
Parámetros | |
---|---|
server | DeviceManagementGrpcServer |
setDeviceManager
public abstract void setDeviceManager (IDeviceManager deviceManager)
Configure el IDeviceManager
, reemplazando cualquier valor existente. Esto establece el administrador de los dispositivos de prueba
configurarDeviceMonitor
public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)
Configure el IDeviceMonitor
.
Parámetros | |
---|---|
deviceMonitor | IDeviceMonitor : El monitor |
Lanza | |
---|---|
ConfigurationException | si ya se ha configurado un IDeviceMonitor . |
establecer los requisitos del dispositivo
public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)
Establezca IDeviceSelection
, reemplazando cualquier valor existente. Esto establece un filtro de dispositivo global en qué dispositivos puede ver DeviceManager
.
establecer monitores de host
public abstract void setHostMonitors (hostMonitors)
Configure la lista IHostMonitor
.
Parámetros | |
---|---|
hostMonitors |
Lanza | |
---|---|
ConfigurationException | si ya se ha configurado un IHostMonitor . |
establecerHostOptions
public abstract void setHostOptions (IHostOptions hostOptions)
Establezca IHostOptions
, reemplazando cualquier valor existente.
setHostResourceManager
public abstract void setHostResourceManager (IHostResourceManager hostResourceManager)
Configure el IHostResourceManager
, reemplazando cualquier valor existente.
establecer servidor de invocación
public abstract void setInvocationServer (TestInvocationManagementServer server)
Establece TestInvocationManagementServer
.
Parámetros | |
---|---|
server | TestInvocationManagementServer |
setKeyStoreFactory
public abstract void setKeyStoreFactory (IKeyStoreFactory factory)
Configure IKeyStoreFactory
, reemplazando cualquier valor existente.
setOptionsFromCommandLineArgs
public abstractsetOptionsFromCommandLineArgs ( listArgs)
Establezca los campos Option
de configuración global con un conjunto dado de argumentos de línea de comando
ArgsOptionParser
para el formato esperadoParámetros | |
---|---|
listArgs |
Devoluciones | |
---|---|
los argumentos no consumidos |
Lanza | |
---|---|
ConfigurationException |
setOriginalConfig
public abstract void setOriginalConfig (String config)
Establece la configuración original utilizada para crear la configuración global.
Parámetros | |
---|---|
config | String |
setResourceMetricCollector
public abstract void setResourceMetricCollector (IResourceMetricCollector collector)
Establece el IResourceMetricCollector
.
Parámetros | |
---|---|
collector | IResourceMetricCollector |
setSandboxFactory
public abstract void setSandboxFactory (ISandboxFactory factory)
Configure ISandboxFactory
, reemplazando cualquier valor existente.
setShardingStrategy
public abstract void setShardingStrategy (IShardHelper sharding)
Establece el IShardHelper
que se usará al fragmentar una configuración.
Parámetros | |
---|---|
sharding | IShardHelper |
setTradefedFeatureServer
public abstract void setTradefedFeatureServer (TradefedFeatureServer server)
Establece TradefedFeatureServer
.
Parámetros | |
---|---|
server | TradefedFeatureServer |
establecerWtfHandler
public abstract void setWtfHandler (ITerribleFailureHandler wtfHandler)
Configure el ITerribleFailureHandler
.
Parámetros | |
---|---|
wtfHandler | ITerribleFailureHandler : el controlador WTF |
Lanza | |
---|---|
ConfigurationException | si ya se ha establecido un ITerribleFailureHandler . |
configuración
public abstract void setup ()
Configuración adecuada al comienzo de tradefed.
Lanza | |
---|---|
| com.android.tradefed.config.ConfigurationException |
ConfigurationException |
validarOpciones
public abstract void validateOptions ()
Validar valores de opciones.
Actualmente, esto solo validará que se hayan configurado todas las opciones obligatorias
Lanza | |
---|---|
ConfigurationException | si faltan campos obligatorios en la configuración |