IGlobalConfiguration

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration

Une classe pour englober les informations de configuration globales pour une seule instance de fédération commerciale (englobant n'importe quel nombre d'invocations de configurations réelles).

Résumé

Méthodes publiques

abstract void cleanup ()

Nettoyage approprié lors de l'arrêt du tradefed.

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

Filtrez la configuration globale en fonction d'une liste blanche et de la sortie dans un fichier XML.

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

Filtrez la configuration globale en fonction d'une liste blanche tout en permettant la manipulation des valeurs d'option et la sortie dans un fichier XML.

abstract File cloneConfigWithFilter (String... allowlistConfigs)

Filtrez la configuration globale en fonction d'une liste autorisée et de la sortie dans un fichier XML.

abstract ICommandScheduler getCommandScheduler ()

Obtient le ICommandScheduler à utiliser à partir de la configuration.

abstract Object getConfigurationObject (String typeName)

Obtient l'objet de configuration personnalisé avec le nom donné.

abstract ICredentialFactory getCredentialFactory ()

Obtient ICredentialFactory pour créer des informations d'identification.

abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Renvoie le DeviceManagementGrpcServer ou null si non défini.

abstract IDeviceManager getDeviceManager ()

Obtient le IDeviceManager à utiliser à partir de la configuration.

abstract getDeviceMonitors ()

Obtient la liste de IDeviceMonitor à partir de la configuration globale.

abstract IDeviceSelection getDeviceRequirements ()

Obtient le IDeviceSelection à utiliser à partir de la configuration.

abstract TradefedFeatureServer getFeatureServer ()

Renvoie le TradefedFeatureServer ou null si non défini.

abstract IConfigurationServer getGlobalConfigServer ()

Obtient le serveur de configuration global.

abstract getHostMonitors ()

Obtient la liste de IHostMonitor à partir de la configuration globale.

abstract IHostOptions getHostOptions ()

Obtient les IHostOptions à utiliser à partir de la configuration.

abstract IHostResourceManager getHostResourceManager ()

Obtient IHostResourceManager à partir de la configuration globale.

abstract IKeyStoreFactory getKeyStoreFactory ()

Obtient le IKeyStoreFactory à utiliser à partir de la configuration.

abstract getMultiDeviceRecoveryHandlers ()

Obtient la liste des IMultiDeviceRecovery à utiliser à partir de la configuration.

abstract getOptionValues (String optionName)

Obtenez une liste des valeurs d'option.

abstract getResourceMetricCollectors ()

Obtient la liste de IResourceMetricCollector à partir de la configuration globale.

abstract ISandboxFactory getSandboxFactory ()

Obtenez une fabrique de sandbox qui peut être utilisée pour exécuter une invocation

abstract IShardHelper getShardingStrategy ()

Renvoie le IShardHelper qui définit la manière de partitionner une configuration.

abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Renvoie le TestInvocationManagementServer ou null si non défini.

abstract ITerribleFailureHandler getWtfHandler ()

Obtient le ITerribleFailureHandler à utiliser à partir de la configuration.

abstract void injectOptionValue (String optionName, String optionValue)

Injectez une valeur d'option dans l'ensemble d'objets de configuration.

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

Injectez une valeur d'option dans l'ensemble d'objets de configuration.

abstract void setCommandScheduler ( ICommandScheduler scheduler)

Définissez le ICommandScheduler , en remplaçant toutes les valeurs existantes.

abstract void setConfigurationFactory ( IConfigurationFactory configFactory)

Définissez IConfigurationFactory pour cette configuration.

abstract void setConfigurationObject (String name, Object configObject)

Méthode générique pour définir l'objet de configuration avec le nom donné, en remplaçant toute valeur existante.

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

Méthode générique pour définir la liste d'objets de configuration pour le nom donné, remplaçant toute valeur existante.

abstract void setDeviceManagementServer ( DeviceManagementGrpcServer server)

Définit le DeviceManagementGrpcServer .

abstract void setDeviceManager ( IDeviceManager deviceManager)

Définissez le IDeviceManager , en remplaçant toutes les valeurs existantes.

abstract void setDeviceMonitor ( IDeviceMonitor deviceMonitor)

Définissez IDeviceMonitor .

abstract void setDeviceRequirements ( IDeviceSelection deviceSelection)

Définissez IDeviceSelection en remplaçant toutes les valeurs existantes.

abstract void setHostMonitors ( hostMonitors) setHostMonitors ( hostMonitors)

Définissez la liste IHostMonitor .

abstract void setHostOptions ( IHostOptions hostOptions)

Définissez IHostOptions en remplaçant toutes les valeurs existantes.

abstract void setHostResourceManager ( IHostResourceManager hostResourceManager)

Définissez le IHostResourceManager , en remplaçant toutes les valeurs existantes.

abstract void setInvocationServer ( TestInvocationManagementServer server)

Définit le TestInvocationManagementServer .

abstract void setKeyStoreFactory ( IKeyStoreFactory factory)

Définissez IKeyStoreFactory en remplaçant toutes les valeurs existantes.

abstract setOptionsFromCommandLineArgs ( listArgs) setOptionsFromCommandLineArgs ( listArgs)

Définissez les champs Option de configuration globale avec un ensemble donné d'arguments de ligne de commande

Voir ArgsOptionParser pour le format attendu

abstract void setOriginalConfig (String config)

Définit la configuration d'origine utilisée pour créer la configuration globale.

abstract void setResourceMetricCollector ( IResourceMetricCollector collector)

Définit le IResourceMetricCollector .

abstract void setSandboxFactory ( ISandboxFactory factory)

Définissez ISandboxFactory , en remplaçant toutes les valeurs existantes.

abstract void setShardingStrategy ( IShardHelper sharding)

Définit IShardHelper à utiliser lors du partitionnement d'une configuration.

abstract void setTradefedFeatureServer ( TradefedFeatureServer server)

Définit le TradefedFeatureServer .

abstract void setWtfHandler ( ITerribleFailureHandler wtfHandler)

Définissez le ITerribleFailureHandler .

abstract void setup ()

Configuration correcte au début de tradefed.

abstract void validateOptions ()

Validez les valeurs des options.

Méthodes publiques

nettoyer

public abstract void cleanup ()

Nettoyage approprié lors de l'arrêt du tradefed.

cloneConfigWithFiltercloneConfigWithFilter

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

Filtrez la configuration globale en fonction d'une liste blanche et de la sortie dans un fichier XML.

Paramètres
exclusionPatterns : modèle de nom de classe à exclure du vidage.

allowlistConfigs String : un tableau ERROR(/String) de configurations à inclure dans le nouveau fichier XML. S'il est défini sur null , a default list should be used.

Retour
File le fichier contenant la nouvelle configuration globale filtrée.

Lance
IOException

cloneConfigWithFiltercloneConfigWithFilter

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

Filtrez la configuration globale en fonction d'une liste blanche tout en permettant la manipulation des valeurs d'option et la sortie dans un fichier XML.

Paramètres
exclusionPatterns : modèle de nom de classe à exclure du vidage.

transformer IConfigOptionValueTransformer

deepCopy boolean

allowlistConfigs String : un tableau ERROR(/String) de configurations à inclure dans le nouveau fichier XML. S'il est défini sur null , a default list should be used.

Retour
File le fichier contenant la nouvelle configuration globale filtrée.

cloneConfigWithFiltercloneConfigWithFilter

public abstract File cloneConfigWithFilter (String... allowlistConfigs)

Filtrez la configuration globale en fonction d'une liste autorisée et de la sortie dans un fichier XML.

Par exemple, pour la configuration suivante : <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>

toutes les configurations sauf "key_store" seront filtrées et le résultat sera un fichier de configuration avec le contenu suivant : <xml> <configuration> <key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" /> </configuration> </xml>

Paramètres
allowlistConfigs String : un tableau ERROR(/String) de configurations à inclure dans le nouveau fichier XML. S'il est défini sur null , a default list should be used.

Retour
File le fichier contenant la nouvelle configuration globale filtrée.

Lance
IOException

getCommandScheduler

public abstract ICommandScheduler getCommandScheduler ()

Obtient le ICommandScheduler à utiliser à partir de la configuration.

Retour
ICommandScheduler le ICommandScheduler . Ne retournera jamais null.

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

Obtient l'objet de configuration personnalisé avec le nom donné.

Paramètres
typeName String : le type unique de l'objet de configuration

Retour
Object l'objet ou null si l'objet portant ce nom n'est pas trouvé

getCredentialFactory

public abstract ICredentialFactory getCredentialFactory ()

Obtient ICredentialFactory pour créer des informations d'identification.

Retour
ICredentialFactory ICredentialFactory ou null si aucun n'a été spécifié.

getDeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

Renvoie le DeviceManagementGrpcServer ou null si non défini.

Retour
DeviceManagementGrpcServer

getDeviceManager

public abstract IDeviceManager getDeviceManager ()

Obtient le IDeviceManager à utiliser à partir de la configuration. Gère l'ensemble des appareils disponibles pour les tests

Retour
IDeviceManager l' IDeviceManager fourni dans la configuration.

getDeviceMonitors

public abstract  getDeviceMonitors ()

Obtient la liste de IDeviceMonitor à partir de la configuration globale.

Retour
la liste de IDeviceMonitor de la configuration globale, ou null si aucun n'a été spécifié.

getDeviceRequirements

public abstract IDeviceSelection getDeviceRequirements ()

Obtient le IDeviceSelection à utiliser à partir de la configuration. Représente un filtre global sur lequel les périphériques que le DeviceManager peut voir.

Retour
IDeviceSelection IDeviceSelection fourni dans la configuration.

getFeatureServer

public abstract TradefedFeatureServer getFeatureServer ()

Renvoie le TradefedFeatureServer ou null si non défini.

Retour
TradefedFeatureServer

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

Obtient le serveur de configuration global. Le serveur de configuration global est utilisé pour obtenir les configurations d'hôte à partir d'un serveur au lieu de les obtenir à partir de fichiers locaux.

Retour
IConfigurationServer

getHostMonitors

public abstract  getHostMonitors ()

Obtient la liste de IHostMonitor à partir de la configuration globale.

Retour
la liste de IHostMonitor de la configuration globale, ou null si aucun n'a été spécifié.

getHostOptions

public abstract IHostOptions getHostOptions ()

Obtient les IHostOptions à utiliser à partir de la configuration.

Retour
IHostOptions l' IDeviceManager fourni dans la configuration.

getHostResourceManager

public abstract IHostResourceManager getHostResourceManager ()

Obtient IHostResourceManager à partir de la configuration globale.

Retour
IHostResourceManager le IHostResourceManager de la configuration globale, ou l'implémentation par défaut LocalHostResourceManager si aucune n'est spécifiée dans la configuration de l'hôte.

getKeyStoreFactory

public abstract IKeyStoreFactory getKeyStoreFactory ()

Obtient le IKeyStoreFactory à utiliser à partir de la configuration.

Retour
IKeyStoreFactory IKeyStoreFactory ou null si aucune fabrique de magasin de clés n'est définie.

getMultiDeviceRecoveryHandlers

public abstract  getMultiDeviceRecoveryHandlers ()

Obtient la liste des IMultiDeviceRecovery à utiliser à partir de la configuration.

Retour
la liste de IMultiDeviceRecovery , ou null si non défini.

getOptionValues

public abstract  getOptionValues (String optionName)

Obtenez une liste des valeurs d'option.

Paramètres
optionName String : le nom de l'option de carte

Retour
une liste des valeurs de l'option donnée. null si le nom de l'option n'existe pas.

getResourceMetricCollectors

public abstract  getResourceMetricCollectors ()

Obtient la liste de IResourceMetricCollector à partir de la configuration globale.

Retour
la liste des IResourceMetricCollector de la configuration globale ou null si aucun n'a été spécifié.

getSandboxFactory

public abstract ISandboxFactory getSandboxFactory ()

Obtenez une fabrique de sandbox qui peut être utilisée pour exécuter une invocation

Retour
ISandboxFactory

getShardingStrategy

public abstract IShardHelper getShardingStrategy ()

Renvoie le IShardHelper qui définit la manière de partitionner une configuration.

Retour
IShardHelper

getTestInvocationManagementSever

public abstract TestInvocationManagementServer getTestInvocationManagementSever ()

Renvoie le TestInvocationManagementServer ou null si non défini.

Retour
TestInvocationManagementServer

getWtfHandler

public abstract ITerribleFailureHandler getWtfHandler ()

Obtient le ITerribleFailureHandler à utiliser à partir de la configuration. Gère ce qu'il faut faire dans le cas où un WTF (What a Terrible Failure) se produit.

Retour
ITerribleFailureHandler le ITerribleFailureHandler fourni dans la configuration, ou null si aucun gestionnaire n'est défini

injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

Injectez une valeur d'option dans l'ensemble d'objets de configuration.

Utile pour fournir des valeurs aux options générées dynamiquement.

Paramètres
optionName String : le nom de l'option

optionValue String : la ou les valeurs de l'option

Lance
ConfigurationException en cas d'échec de la définition de la valeur de l'option

injectOptionValue

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

Injectez une valeur d'option dans l'ensemble d'objets de configuration.

Utile pour fournir des valeurs aux options générées dynamiquement.

Paramètres
optionName String : le nom de l'option de carte

optionKey String : la clé d'option de la carte

optionValue String : la valeur de l'option de carte

Lance
ConfigurationException en cas d'échec de la définition de la valeur de l'option

setCommandScheduler

public abstract void setCommandScheduler (ICommandScheduler scheduler)

Définissez le ICommandScheduler , en remplaçant toutes les valeurs existantes.

setConfigurationFactorysetConfigurationFactory

public abstract void setConfigurationFactory (IConfigurationFactory configFactory)

Définissez IConfigurationFactory pour cette configuration.

Paramètres
configFactory IConfigurationFactory

setConfigurationObjectsetConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

Méthode générique pour définir l'objet de configuration avec le nom donné, en remplaçant toute valeur existante.

Paramètres
name String : le nom unique du type d'objet de configuration.

configObject Object : l'objet de configuration

Lance
ConfigurationException si le configObject n'était pas du bon type

setConfigurationObjectListsetConfigurationObjectList

public abstract void setConfigurationObjectList (String typeName, 
                 configList)

Méthode générique pour définir la liste d'objets de configuration pour le nom donné, remplaçant toute valeur existante.

Paramètres
typeName String : le nom unique du type d'objet de configuration.

configList : la liste des objets de configuration

Lance
ConfigurationException si des objets de la liste ne sont pas du bon type

setDeviceManagementServersetDeviceManagementServer

public abstract void setDeviceManagementServer (DeviceManagementGrpcServer server)

Définit le DeviceManagementGrpcServer .

Paramètres
server DeviceManagementGrpcServer

setDeviceManager

public abstract void setDeviceManager (IDeviceManager deviceManager)

Définissez le IDeviceManager , en remplaçant toutes les valeurs existantes. Cela définit le gestionnaire pour les appareils de test

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

Définissez IDeviceMonitor .

Paramètres
deviceMonitor IDeviceMonitor : Le moniteur

Lance
ConfigurationException si un IDeviceMonitor a déjà été défini.

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

Définissez IDeviceSelection en remplaçant toutes les valeurs existantes. Cela définit un filtre de périphérique global sur lequel les périphériques que le DeviceManager peut voir.

setHostMonitorssetHostMonitors

public abstract void setHostMonitors ( hostMonitors)

Définissez la liste IHostMonitor .

Paramètres
hostMonitors : La liste des moniteurs

Lance
ConfigurationException si un IHostMonitor a déjà été défini.

setHostOptions

public abstract void setHostOptions (IHostOptions hostOptions)

Définissez IHostOptions en remplaçant toutes les valeurs existantes.

setHostResourceManager

public abstract void setHostResourceManager (IHostResourceManager hostResourceManager)

Définissez le IHostResourceManager , en remplaçant toutes les valeurs existantes.

setInvocationServersetInvocationServer

public abstract void setInvocationServer (TestInvocationManagementServer server)

Définit le TestInvocationManagementServer .

Paramètres
server TestInvocationManagementServer

setKeyStoreFactorysetKeyStoreFactory

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

Définissez IKeyStoreFactory en remplaçant toutes les valeurs existantes.

setOptionsFromCommandLineArgssetOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

Définissez les champs Option de configuration globale avec un ensemble donné d'arguments de ligne de commande

Voir ArgsOptionParser pour le format attendu

Paramètres
listArgs : les arguments de la ligne de commande

Retour
les arguments non consommés

Lance
ConfigurationException

setOriginalConfig

public abstract void setOriginalConfig (String config)

Définit la configuration d'origine utilisée pour créer la configuration globale.

Paramètres
config String

setResourceMetricCollectorsetResourceMetricCollector

public abstract void setResourceMetricCollector (IResourceMetricCollector collector)

Définit le IResourceMetricCollector .

Paramètres
collector IResourceMetricCollector

setSandboxFactory

public abstract void setSandboxFactory (ISandboxFactory factory)

Définissez ISandboxFactory , en remplaçant toutes les valeurs existantes.

setShardingStrategy

public abstract void setShardingStrategy (IShardHelper sharding)

Définit IShardHelper à utiliser lors du partitionnement d'une configuration.

Paramètres
sharding IShardHelper

setTradefedFeatureServer

public abstract void setTradefedFeatureServer (TradefedFeatureServer server)

Définit le TradefedFeatureServer .

Paramètres
server TradefedFeatureServer

setWtfHandler

public abstract void setWtfHandler (ITerribleFailureHandler wtfHandler)

Définissez le ITerribleFailureHandler .

Paramètres
wtfHandler ITerribleFailureHandler : le gestionnaire WTF

Lance
ConfigurationException si un ITerribleFailureHandler a déjà été défini.

installation

public abstract void setup ()

Configuration correcte au début de tradefed.

Lance
com.android.tradefed.config.ConfigurationException
ConfigurationException

validerOptions

public abstract void validateOptions ()

Validez les valeurs des options.

Actuellement, cela ne fera que valider que toutes les options obligatoires ont été définies

Lance
ConfigurationException si la configuration manque des champs obligatoires