Passage en mode développeur
Pour lancer les mesures sur les tests en mode local, il est nécessaire de passer votre smartphone Android en mode “développeur”
Accédez aux paramètres de l’appareil Android:
Allez dans les paramètres système
Allez dans « À propos du téléphone »
Tapotez 7 fois sur la section « numéro de build ». Une popup apparaît indiquant que les options développeurs sont activées
Retourner dans les paramètres, les options pour les développeurs doivent apparaître
Aller dans les options developpeur et activer l'option «Débogage USB»
Le mode opératoire peut varier en fonction du modèle du smartphone. Plus d’information, ce tutoriel externe est disponible ici
Connecter votre smartphone à votre PC via un câble USB
Pour permettre l’envoi du scénario de test et la récupération des métriques mesurées, il est nécessaire de connecter votre smartphone à votre ordinateur via un câble USB avant de faire les prochaines étapes.
Valider l’accès à votre application
Sur votre smartphone local, vérifiez que vous parvenez à utiliser correctement votre application : l’application mobile atteint bien tous vos serveurs, votre application Web accède bien à tous vos services Web, nécessaires à son bon fonctionnement.
Avoir une application accessible, un smartphone et un compte google lié au Play Store paramétrés en anglais (United Kingdom) sont des prérequis nécessaires à la conduite d’une mesure.
Installation des outils pour communiquer avec votre téléphone Android
Android Debug Bridge (ADB) est un outil en ligne de commande permettant d’interagir avec un smartphone Android depuis votre ordinateur. C’est ce qui va vous permettre de lancer les tests sur votre smartphone local depuis votre ordinateur.
Si vous n’avez pas encore d’environnement ADB installé sur votre ordinateur, veuillez l’installer. Pour cela vous pouvez télécharger et décompresser les fichiers suivants
TODO
Téléchargement de l'outil TestRunner pour lancer les tests
Le TestRunner est la boite à outil permettant de lancer le scénario de test sur votre smartphone local et d’en récupérer des métriques, qui seront envoyées sur le service Greenspector. Lien pour le téléchargement.
Il est nécessaire de télécharger cet outil au même endroit que vous avez téléchargé l'outil CLI (sur votre ordinateur local). Vous devrez rester dans ce répertoire pour les prochaines étapes.
Téléchargement des fichiers de configuration
En plus du fichier de description de votre scénario de test, vous aurez besoin d’un fichier de configuration pour lancer vos tests sur un smartphone local avec le TestRunner.
Veuillez télécharger les fichiers de configuration (YML) suivants dans votre répertoire de travail utilisé précédemment, sur l’ordinateur connecté au smartphone local.
TODO
Modification du fichier 'Config File'
Editer le fichier config.yml que vous venez de récupérer:
Remplacer le texte '${PATH_TO_ADB}' par le chemin sur l'éxécutable adb. Cet exécutable se trouve dans le platform-tools.zip que vous avez récupéré. Vous pouvez mettre simplement adb si adb est déjà dans le path de votre machine.
Remplacer le texte '${PATH_TO_AAPT}' par le chemin sur l'éxécutable aapt. Cet exécutable se trouve dans le build-tools.zip que vous avez récupéré. Vous pouvez mettre simplement aapt si aapt est déjà dans le path de votre machine.
Remplacer le texte '${PHONE_SERIAL} par le numéro de série de votre téléphone. Ce numéro est celui affiché grâce à la commande 'adb devices' lorsque votre smartphone est connecté en USB à votre ordinateur.
Modification du fichier 'Job File'
Editer le fichier job.yml que vous venez de récupérer:
Vous pouvez changer le fichier de test './script.testgb' si vous voulez utiliser un autre fichier que le script de test récupéré à l'étape 2.
Lancement des tests en local
Vous allez maintenant lancer des tests sur votre smartphone local depuis votre ordinateur. Pour cela, vous allez vous appuyer sur le scénario de test que nous vous avons fourni ou que vous aurez défini, et les fichiers de configuration YML précédemment fournis.
Dans une invite de commande, depuis le même répertoire que les fichiers de configuration YML, lancez la commande suivante
testrunner
Attente de la fin des tests dans l’invite de commande
Les tests sont lancés et la mesure (intermédiaire) est en cours. Il faut attendre que le scénario de test s’exécute, au même rythme que pour un utilisateur humain : cela peut donc prendre quelque temps. Vous pouvez d’ailleurs contrôler son bon déroulement depuis l’écran de votre smartphone local.
A la fin de l’exécution du scénario de test, un retour apparaît dans l'invite de commande. Ainsi, vous pouvez analyser les potentielles erreurs, ou contrôler que tout s’est bien passé.
Si vous rencontrez des erreurs, il vous faudra très certainement modifier votre fichier de scénario utilisateur pour les corriger et relancer la mesure intermédiaire.
Pour plus d’aide sur comment résoudre les erreurs, consultez la section 'Quelques pistes si le test ne fonctionne pas' dans l'aide 'Prérequis à l'usage du langage GDSL' de cette étape ou bien la documentation Greenspector.
Durant l’exécution du test, ne pas débrancher le smartphone, ne pas interagir avec lui et ne pas fermer l’invite de commande.
Résultats de la mesure
Votre script a fini de s’exécuter sur votre smartphone local et les mesures sont terminées : vous pouvez visualiser les résultats intermédiaires sur votre terminal (succès ou erreurs) ou dans le fichier greenspector>[date_mesure]>tests-results>results.txt.
En cas de succès, vous pouvez continuer à ajouter des étapes dans votre scénario et relancer un test local.
En cas d’erreur, un message dans votre terminal vous indique la source de cette erreur. Pour mieux comprendre où se situe l’erreur dans le script, vous pouvez aussi consulter les captures d'écran qui sont prises à chaque étape de mesure. Chaque image porte le nom de l'étape de votre script GDSL, et l’image intitulée “failed” vous montre l'état du smartphone lors de l’erreur. Ces captures sont accessibles dans le répertoire local depuis lequel vous effectuez les tests intermédiaires, dans greenspector>[date_mesure]>tests-results>suite1>script>iteration 1>screenshots.
