Charger des protocoles avec une configuration globale

Pour bien comprendre cette section, vous devez d'abord étudier @Option

Les options courantes de Tradefed permettent aux classes de test de recevoir à partir de la configuration XML ou de la ligne de commande. Cette fonctionnalité vous permet d'aller plus loin et de résoudre certaines de ces informations supplémentaires nécessaires.

Exemple d'option de fichier

Exemple de fichier @option:

@Option(name = 'config-file')
private File mConfigFile;

Les éléments ci-dessus peuvent être définis via une configuration XML:

<option name="config-file" value="/tmp/file" />

ou via une commande:

--config-file /tmp/file

Description

Cette fonctionnalité vous permet de résoudre les @Options de type fichier distants dans un d'un fichier local d'être disponible facilement du point de vue de l'utilisateur.

Pour que cela fonctionne, le fichier doit être spécifié avec un chemin d'accès de style distant. Exemple :

--config-file gs://bucket/tmp/file

Ce chemin d'accès pointe vers un fichier dans un bucket Google Cloud Storage (GCS) où il se trouve stockées. Tradefed après avoir vu ce chemin distant, tentera de télécharger le fichier localement et l’affecter à @Option. Cela se traduit par la variable mConfigFile. de pointer vers la version locale du fichier, qui peut être utilisée par le test.

Si, pour une raison quelconque, le fichier distant ne peut pas être téléchargé, Tradefed génère une ConfigurationException qui empêchera l'exécution du test. Nous prenons en compte manquer ces fichiers un échec critique puisque certains artefacts de test seront également sont manquantes.

Utiliser des paramètres de requête

Vous pouvez ajouter des paramètres de requête à une URL à l'aide de ?. Par exemple, gs://bucket/path?unzip=true. La clé-valeur unzip=true sera disponible dans la classe IRemoteFileResolver de commande la mise en œuvre.

Deux comportements intégrés sont disponibles:

  • unzip: si la valeur est true et que le fichier téléchargé est au format ZIP, il sera automatiquement décompressé dans un emplacement temporaire. Exemple: ?unzip=true
  • (facultatif) : la valeur par défaut est false. Si la valeur est true et que la résolution échoue, ne générera pas d'exception et ne remplacera tout simplement pas le fichier. Exemple: ?optional=true

Vous pouvez également transmettre des arguments de requête globaux via --dynamic-download-args key=value. qui transmet la clé-valeur à tous les téléchargements dynamiques tentés dans le appel.

Protocoles compatibles

Les protocoles officiellement acceptés et les formats correspondants sont les suivants:

  • Google Cloud Storage, protocole: gs, format: gs://<bucket name>/path
  • Fichiers locaux, protocole: file, format: file:/local/path
  • Liens HTTP, protocole: http, format: http://url
  • Liens https, protocole: https, format: https://url

Limites

La résolution dynamique de @Option n'accepte actuellement qu'un nombre limité de des protocoles et des emplacements à partir desquels télécharger. La résolution de @Option est actuellement activé uniquement pour la configuration principale XML Tradefed.

S'ils sont exécutés en tant que suite, les modules actuels (AndroidTest.xml) ne résoudront pas le problème fichiers par défaut. Cela vise à empêcher les modules de créer des dépendances inconnues. Ce peuvent être échappés à l'aide de --enable-module-dynamic-download au niveau de la suite. mais des suites majeures telles que la Compatibility Test Suite (CTS) et la suite de test pour les fournisseurs (VTS) ne l'active pas.

Implémenter un nouveau protocole

Les protocoles pris en charge disposent d'une implémentation dans Tradefed IRemoteFileResolver de l'interface ,qui définit le tag court du protocole qui sera mis en correspondance dans jusqu'à getSupportedProtocol. Par exemple, gs est utilisé pour Protocole Google Cloud Storage. L'interface recommandée à implémenter est #resolveRemoteFiles(RemoteFileResolverArgs), qui correspond à la période à long terme gérée.

Les protocoles implémentés peuvent être ajoutés au fichier harce META-INF. services pour activer officiellement la prise en charge.