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 esttrue
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.