Lancer des test en local (Android)

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 App

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

• Aller dans le menu Applications

• Cliquer sur Ajouter une application

• Saisir un nom, une première version et une description (non obligatoire)

• Valider

Compléter les fichiers

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

Open

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

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

Open

Pop up USB debugging

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

• 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 app.greenspector.com 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.

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 https://app.greenspector.com/app/list par online=true dans job.yml, la nouvelle version est visible dans l’onglet Meter.