Lancer des test en local (Android)

MAJ 31 OCT 2024

Dans cette section, vous découvrirez comment lancer une analyse de parcours fonctionnel sur un appareil Android local, comme cela a été décrit dans la partie Prise en main.

Préparation

Paramètres

Dans les options d’affichage :

Configurer l'adaptation de la luminosité en mode manuel
Régler le délai de mise en veille du téléphone au maximum

Dans les paramètres de langue :

Si possible, réglez la langue sur "English - United Kingdom".

Validation de l’accès à l’application

Sur votre smartphone local, vérifiez que vous pouvez utiliser votre application correctement : l'application mobile accède à tous les serveurs, et l'application web accède à tous les services web, qui sont nécessaires à son bon fonctionnement.

[Optionnel] Créer une application sur Greenspector Studio

Si ce n'est pas le cas et que vous souhaitez enregistrer des mesures sur l'interface web, créez une application sur Greenspector Studio.

Aller dans le menu Applications
Cliquer sur Nouvelle analyse
Remplir les informations demandées
Valider

Compléter les fichiers

Pour lancer les tests, l'exécutable testrunner a besoin de fichiers de config et de job. Pour plus d'informations sur le contenu de ces fichiers, consultez la section Fichiers complémentaires (Android).

Modification du fichier config.yml

Editez le fichier config.yml, remplissez ou remplacez :

${PHONE_IP} par l'adresse IP du téléphone
${PHONE_PORT} par 5555
${PATH_TO_ADB} par le chemin d'accès à l'exécutable adb. Inscrivez simplement "adb" si cette commande figure déjà dans vos variables d'environnement.
${PATH_TO_AAPT} par le chemin de l'exécutable aapt. Écrivez simplement "aapt" si cette commande figure déjà dans vos variables d'environnement.
${GREENSPECTOR_CORE_SERVER_URL} par https://app.greenspector.com
${PRIVATE_TOKEN} par votre token. Pour trouver votre token, aller dans l'interface du Greenspector, cliquer sur votre nom en haut à droite, puis cliquer sur l'onglet "Préférences".

Modification du fichier job.yml

Editez le fichier job.yml, remplissez ou remplacez :

${APP_NAME} par le nom de l'application.
${APP_VERSION} par la version testée (date, version de l'application, autre).
Dans le champ testFiles, entrer le chemin d'accès au scénario de test.
${MONITORED_PACKAGE} par le nom de package de l’application. Si c’est un site web, écrire "com.android.chrome".
${PAUSEDURATION} par 1000 (1000 ms, soit 1 seconde)
${PAUSEAFTERLOAD} par 1000 (1000 ms, soit 1 seconde)

Lancement d’une analyse de parcours fonctionnel sur un appareil Android en local

Le lancement d'un parcours fonctionnel sur un dispositif local nécessite :

Script GDSL
job.yml & config.yml
Smartphone connecté en adb

Rappels :

Connecter un smartphone en adb USB

Activer le débogage USB

Pour lancer des mesures sur des tests en mode local, le testeur Greenspector doit établir une connexion ADB (Android Debug Bridge) avec l'appareil local. Un accès aux options de développement Android est nécessaire :

Accéder aux paramètres de l'appareil Android
Accéder à About phone > Software information section
Taper 7 fois sur la section Build Number. Une pop-up confirme l'activation.
Retourner à Settings / Developer options
Activer l’option USB debugging

La procédure peut varier considérablement d'un appareil à l'autre. Veuillez suivre le tutoriel officiel d'Android pour plus d'informations : Configurer les options développeurs.

Connecter l’appareil au PC

Brancher l'appareil sur un ordinateur à l'aide d'un câble USB.
Exécuter les commandes suivantes pour vérifier la connexion USB :

adb kill-server
adb devices

adb kill-server n'est pas obligatoire, mais redémarrer adb permet d'éviter les problèmes de connexion.

L'appareil devrait être détecté. Une pop-up Allow USB debugging? doit apparaître sur l'appareil. Cliquer sur Allow:

Connecter un smartphone en adb WiFi

Activer ADB Wifi

Connecter votre appareil via le port USB
Vérifier la connexion ADB :

adb kill-server
adb devices

adb kill-server n'est pas obligatoire, mais le redémarrage d'adb permet d'éviter les problèmes de connexion.

L'appareil devrait être détecté. Une pop-up Allow USB debugging? doit apparaître sur l'appareil. Cliquer sur Allow:

Exécuter la commande suivante pour activer la connexion au réseau :

adb tcpip 5555

Débrancher le câble USB de votre appareil
Exécuter la commande suivante pour établir la connexion réseau :

adb connect [IP]:5555

Remplacer [IP] par l'adresse IP de l'appareil qui se trouve dans les paramètres de connexion du téléphone.

Exécuter la commande suivante pour vérifier la connexion au réseau :

adb devices

Vous devriez voir que votre appareil est maintenant identifié avec son IP.

Lancement du test

Testrunner est maintenant prêt à être lancé. Il suffit de le lancer pour commencer un test :

Aller dans le dossier où se trouvent les fichiers job et config
Lancer la commande suivante dans le terminal

testrunner

Testrunner reconnait automatiquement config.yml et job.yml.

Si des noms ou des chemins d'accès différents sont utilisés, veuillez les spécifier avec: testrunner -c chemin/monconfig.yml -j chemin/monjob.yml

Pendant l'exécution du test et jusqu'à la fin du test :
- Ne pas fermer le terminal
- Ne pas interagir avec l'appareil. Vérifier l'écran de l'appareil pour voir si le test est en cours.

Résultats

Le Testrunner affiche le résultat à la fin du test. En cas d'échec, la ligne d'erreur est donnée pour aider à adapter le fichier GDSL. Les résultats sont disponibles :

Dans votre répertoire de travail avec greenspector/dd-mm-yyyy XXhXXm/tests-results/results.txt
Sur Greenspector Studio si online est à true dans job.yml.

Pour une meilleure compréhension, des captures d'écran des étapes sont disponibles à l'adresse suivante greenspector/dd-mm-yyyy XXhXXm/tests-results/MONAPP/parcours/iteration 1/screenshots. L'état final est appelé success.png ou failed.png selon le résultat.

Si le test réussit, vous pouvez continuer à écrire votre script en suivant les bonnes pratiques suivantes

Si votre script est terminé et prêt à lancer les mesures officielles, suivez la procédure choisie :

Si le test n'aboutit pas, vous pouvez consulter les fichiers de rapport d'erreur téléchargeables :

Une ligne problématique dans le fichier de test : Cela peut indiquer que l'élément sur lequel vous essayez de cliquer ou que vous attendez n'est pas accessible ou présent.
L'image failed.png avec une capture d'écran du dernier écran avant l'erreur. Cela vous permet d'identifier rapidement le dysfonctionnement.
Les captures d'écran des étapes qui ont fonctionné avant l'échec.
Le fichier dump.uix, qui contient une extraction de la composition de l'écran. Vous pouvez rechercher dans ce fichier le texte que vous souhaitez automatiser, ainsi que l'identifiant de cet élément.

Si le texte est présent dans l'écran échoué et dans le fichier dump.uix mais que vous obtenez une erreur, il est possible que l'élément ne soit pas techniquement accessible. Vous pouvez rechercher l'identifiant de l'élément dans dump.uix et utiliser un mot-clé d'automatisation tel que clickById ou waitById.

Référez vous à Détails de méthodes et au troubleshooting approprié selon l’erreur affichée.

Erreurs récurrentes

Changement de version

Il est possible de modifier la version des résultats de mesure autant de fois que nécessaire. Il peut s'agir d'une date, d'une nouvelle version de l'application ou du site web, d'un parcours différent, d'un test de fonctionnalité, de conditions de test différentes, etc.

Changer dans job.yml :

${APP_VERSION} par la version testée.

Si vous avez renseigné que les mesures s’enregistrent en ligne sur Greenspector Studio par online=true dans job.yml, la nouvelle version est visible dans le détail de l’application.