À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

IConfigurationFactory

public interface IConfigurationFactory

com.android.tradefed.config.IConfigurationFactory

Sous-classes indirectes connues

ConfigurationFactory, GCSConfigurationFactory, RetryConfigurationFactory, SandboxConfigurationFactory

ConfigurationFactory	Fabrique permettant de créer des `IConfiguration`.
GCSConfigurationFactory	Un `ConfigurationFactory` charge des configurations à partir de Google Cloud Storage.
RetryConfigurationFactory	Usine qui gère la nouvelle tentative d'une commande.
SandboxConfigurationFactory	Usine de configuration spéciale pour gérer la création de configurations à des fins de bac à sable.

Fabrique permettant de créer des IConfiguration

Résumé

Méthodes publiques
`abstract IConfiguration`	`createConfigurationFromArgs(String[] args, unconsumedArgs)` Créez le `IConfiguration` à partir d'arguments de ligne de commande.
`abstract IConfiguration`	`createConfigurationFromArgs(String[] args)` Méthode pratique qui appelle `ERROR(/#createConfigurationFromArgs(String[],List))` avec un deuxième argument `null`.
`abstract IConfiguration`	`createConfigurationFromArgs(String[] args, unconsumedArgs, IKeyStoreClient keyStoreClient)` Créez le `IConfiguration` à partir d'arguments de ligne de commande avec un magasin de clés.
`abstract IGlobalConfiguration`	`createGlobalConfigurationFromArgs(String[] args, nonGlobalArgs)` Créez un `IGlobalConfiguration` à partir d'arguments de ligne de commande.
`abstract IConfiguration`	`createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator)` Créez une configuration qui ne contient qu'un ensemble d'objets sélectionnés.
`abstract void`	`dumpConfig(String configName, PrintStream out)` Vide le contenu de la configuration dans l'`ERROR(/PrintStream)` donné.
`abstract`	`getConfigList()` Renvoie la liste des noms de toutes les configurations trouvées dans les fichiers JAR du chemin d'accès aux classes.
`abstract`	`getConfigList(String subPath, boolean loadFromEnv)` Variation de `getConfigList()` où vous pouvez spécifier si vous souhaitez également charger la configuration à partir de l'environnement.
`abstract void`	`printHelp(PrintStream out)` Imprime la sortie d'aide pour cette usine.
`abstract void`	`printHelpForConfig(String[] args, boolean importantOnly, PrintStream out)` Affiche la sortie d'aide pour l'`IConfiguration` spécifié dans les arguments de ligne de commande. Si "args" fait référence à une configuration connue, un objet `IConfiguration` est créé à partir du fichier XML, et l'aide de cet `IConfiguration` est générée.

Méthodes publiques

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args, 
                 unconsumedArgs)

Créez le IConfiguration à partir d'arguments de ligne de commande.

Le format attendu est "CONFIG [options]", où CONFIG est le nom de la configuration intégrée ou un chemin d'accès à un fichier XML de configuration.

Paramètres
`args`	`String`: arguments de ligne de commande
`unconsumedArgs`	: liste qui sera renseignée avec les arguments qui n'ont pas été consommés par les objets associés à la configuration spécifiée. Si cette valeur est `null`, l'implémentation génère une exception `ConfigurationException` si des arguments non traités restent.

Renvoie
`IConfiguration`	`IConfiguration` chargé. Les champs `Option` de l'objet délégué ont été renseignés avec des valeurs dans args.

Génère
`ConfigurationException`	si la configuration n'a pas pu être chargée

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args)

Méthode pratique qui appelle ERROR(/#createConfigurationFromArgs(String[],List)) avec un deuxième argument null. Par conséquent, il génère ConfigurationException si des arguments inutilisés restent.

Paramètres
`args`	`String`

Renvoie
`IConfiguration`

Génère
`ConfigurationException`

Voir aussi :

ERROR(/#createConfigurationFromArgs(String[], List))

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args, 
                 unconsumedArgs, 
                IKeyStoreClient keyStoreClient)

Créez le IConfiguration à partir d'arguments de ligne de commande avec un magasin de clés.

Le format attendu est "CONFIG [options]", où CONFIG est le nom de la configuration intégrée ou un chemin d'accès à un fichier XML de configuration.

Paramètres
`args`	`String`: arguments de ligne de commande
`unconsumedArgs`	: liste qui sera renseignée avec les arguments qui n'ont pas été consommés par les objets associés à la configuration spécifiée. Si cette valeur est `null`, l'implémentation génère une exception `ConfigurationException` si des arguments non traités restent.
`keyStoreClient`	`IKeyStoreClient`: `IKeyStoreClient` utilisé pour obtenir des informations sensibles dans les arguments.

Renvoie
`IConfiguration`	`IConfiguration` chargé. Les champs `Option` de l'objet délégué ont été renseignés avec des valeurs dans args.

Génère
`ConfigurationException`	si la configuration n'a pas pu être chargée

createGlobalConfigurationFromArgs

public abstract IGlobalConfiguration createGlobalConfigurationFromArgs (String[] args, 
                 nonGlobalArgs)

Créez un IGlobalConfiguration à partir d'arguments de ligne de commande.

Le format attendu est "CONFIG [options]", où CONFIG est le nom de la configuration intégrée ou un chemin d'accès à un fichier XML de configuration.

Paramètres
`args`	`String`: arguments de ligne de commande
`nonGlobalArgs`	: liste qui sera renseignée avec les arguments qui n'ont pas été traités en tant qu'arguments globaux

Renvoie
`IGlobalConfiguration`	`IGlobalConfiguration` chargé. Les champs `Option` de l'objet délégué ont été renseignés avec des valeurs dans args.

Génère
`ConfigurationException`	si la configuration n'a pas pu être chargée

createPartialConfigurationFromArgs

public abstract IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, 
                IKeyStoreClient keyStoreClient, 
                 allowedObjects, 
                TradefedDelegator delegator)

Créez une configuration qui ne contient qu'un ensemble d'objets sélectionnés.

Paramètres
`arrayArgs`	`String`: arguments de ligne de commande
`keyStoreClient`	`IKeyStoreClient`: `IKeyStoreClient` utilisé pour obtenir des informations sensibles dans les arguments.
`allowedObjects`	: ensemble d'objets autorisés à créer
`delegator`	`TradefedDelegator`

Renvoie
`IConfiguration`	`IConfiguration` chargé.

Génère
`ConfigurationException`	si la configuration n'a pas pu être chargée

dumpConfig

public abstract void dumpConfig (String configName, 
                PrintStream out)

Vide le contenu de la configuration dans l'ERROR(/PrintStream) donné.

Paramètres
`configName`	`String`: nom de la configuration
`out`	`PrintStream`: `ERROR(/PrintStream)` dans lequel vider la sortie

getConfigList

public abstract  getConfigList ()

Renvoie la liste des noms de toutes les configurations trouvées dans les fichiers JAR du chemin d'accès aux classes. Aucune tentative de chargement des configurations n'est effectuée. Il est donc possible que des configurations ne fonctionnent pas dans cette liste.

Renvoie

getConfigList

public abstract  getConfigList (String subPath, 
                boolean loadFromEnv)

Variation de getConfigList() où vous pouvez spécifier si vous souhaitez également charger la configuration à partir de l'environnement.

Paramètres
`subPath`	`String`: nom des sous-répertoires dans lesquels rechercher la configuration. Si la valeur est nulle, le comportement est identique à celui de `getConfigList()`.
`loadFromEnv`	`boolean` : "True" si nous devons charger la configuration dans la variable d'environnement.

Renvoie

printHelp

public abstract void printHelp (PrintStream out)

Imprime la sortie d'aide pour cette usine.

Affiche des informations d'aide génériques et liste toutes les configurations disponibles.

Paramètres
`out`	`PrintStream`: `ERROR(/PrintStream)` dans lequel vider la sortie

printHelpForConfig

public abstract void printHelpForConfig (String[] args, 
                boolean importantOnly, 
                PrintStream out)

Affiche la sortie d'aide pour l'IConfiguration spécifié dans les arguments de ligne de commande.

Si "args" fait référence à une configuration connue, un objet IConfiguration est créé à partir du fichier XML, et l'aide de cet IConfiguration est générée. Notez que toutes les autres valeurs "args" seront ignorées (c'est-à-dire que le texte d'aide décrira les valeurs actuelles des Options telles qu'elles sont chargées à partir du fichier XML et ne reflétera pas les valeurs de l'option définies par les arguments de la ligne de commande.

Si "args" ne fait pas référence à un IConfiguration connu, l'aide générique printHelp(PrintStream) s'affiche.

Paramètres
`args`	`String`: arguments de ligne de commande
`importantOnly`	`boolean`: si `true`, imprime une aide abrégée ne listant que les détails importants
`out`	`PrintStream`: `ERROR(/PrintStream)` dans lequel vider la sortie