...

Le mode opératoire peut varier en fonction du modèle du smartphone. Plus d’information, ce tutoriel externe est disponible ici

...

Autre réglages

Dans les options d’affichage :

...

Installation des outils pour communiquer avec votre téléphone Android

ADB (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, suivez suivre les étapes suivantes :

• Télécharger Android Studio

• Vérifier que l’exécutable “adb” est bien présent à l’emplacement suivant Ajouter ADB (Android Debug Bridge) à vos variables d’environnement :

  • Sur Linux : ajouter la ligne export PATH=$PATH:$HOME/Android/Sdk/platform-tools dans le fichier .bashrc et lancer la commande "source ~/.bashrc"

  • Sur Mac : ajouter la ligne export PATH=$PATH:$HOME/Library/Android/sdk/platform-tools dans le fichier .bash_profile et lancer la commande "source ~/.bash_profile"

  • Sur Windows : Menu Démarrer > Paramètres > Système > À propos de > Paramètres avancés du système > Variables d’environnement > Path > Modifier > Ajouter le path C:\Users\[nom_utilisateur]\AppData\Local\Android\Sdk\platform-tools. Remplacer nom_utilisateur par le nom de l'utilisateur.

...

• Ajouter AAPT (Android Asset Packaging Tool) à vos variables d’environnement :

  • Sur Linux : ajouter la ligne “export export PATH=$PATH:$HOME/Android/Sdk/platform-tools” build-tools/[dossier_aapt]:$PATH dans le fichier .bashrc et lancer la commande “source "source ~/.bashrc”.bashrc". Remplacer dossier_aapt par le nom du dossier aapt.

  • Sur Mac : ajouter la ligne “export export PATH=$PATH:$HOME/Library/Android/sdk/platform-tools” build-tools/[dossier_aapt]:$PATH dans le fichier .bash_profile et lancer la commande “source ~/.bash_profile”. Remplacer dossier_aapt par le nom du dossier aapt.

  • Sur Windows : Menu Démarrer > Paramètres > Système > À propos de > Paramètres avancés du système > Variables d’environnement > Path > Modifier > Ajouter le path vers le dossier contenant l’exécutable adb

  Ouvrir un terminal et lancer la commande “adb”

  • C:\Users\[nom_utilisateur]\AppData\Local\Android\Sdk\build-tools\[dossier_aapt]. Remplacer nom_utilisateur par le nom de l’utilisateur et dossier_aapt par le nom du dossier aapt.

...

Téléchargement de l'outil TestRunner pour lancer les tests

Le TestRunner est la boite boîte à 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 disponible à l’emplacement suivant : Onglet téléchargement des outils > Test Runner : Download.

Téléchargement des fichiers de configuration

En plus du fichier de description de votre scénario de test, vous aurez besoin des fichiers de configuration config.yml et job.yml pour lancer vos tests sur un smartphone local avec le TestRunner.

Un exemple de ces fichiers Ces fichiers permettent de configurer vos tests. Un exemple est disponible à l’emplacement suivant : Onglet téléchargement des outils > Test Runner : Download > “Config - Android” et “Job - Android”

Téléchargement du fichier de scénario de test

Ce fichier sert à décrire un scénario utilisateur sur votre application, qui sera votre scénario de test.

Un exemple de ce fichier est disponible à l’emplacement suivant : Onglet téléchargement des outils > GDSL Templates : Download (vous pouvez choisir entre un fichier de test pour une application Android, un site web, ou une application iOS).

...

Connecter votre smartphone à votre PC via un câble USB

...

• Connecter votre téléphone à votre ordinateur via un câble USB

• Ouvrir un terminal et lancer la commande ci-dessous pour vérifier que le téléphone soit est bien détecté.

adb devices

...

adb connect [adresse_ip_du_téléphone]:5555

Modification du fichier

...

config.yml

Editer le fichier config.yml que vous venez de récupérer:

• Remplacer le texte ' ${PHONE_IP} par l'adresse IP de votre téléphone

• Remplacer ${PHONE_PORT} par 5555

• Remplacer ${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 'de l’exécutable adb. Ecrire simplement “adb” si cette commande est déjà dans vos variables d’environnement.

• Remplacer ${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.

...

• de l’exécutable aapt. Ecrire simplement “aapt” si cette commande est déjà dans vos variables d’environnement.

• Remplacer ${GREENSPECTOR_CORE_SERVER_URL} par https://app.greenspector.com

• Remplacer ${PRIVATE_TOKEN} par votre token. Pour trouver votre token, aller sur l’interface Greenspector, cliquer sur votre nom en haut à droite, puis cliquer sur l’onglet “Preferences”.

Modification du fichier job.yml

Editer le fichier job.yml que vous venez de récupérer:

...

• Remplacer ${APP_NAME} par le nom de votre application. Si vous n’avez pas d’application, aller sur l’interface Greenspector, et cliquer sur “Add an application”.

• Remplacer ${APP_VERSION} par le nom de la version de votre application.

• Dans le champ job.testsSuites.testFiles, indiquer le chemin de votre scénario de test

• Remplacer ${MONITORED_PACKAGE} par le nom du paquet de votre application. En cas de mesure sur un site web, écrire "com.android.chrome".

• Remplacer ${PAUSEDURATION} par 30000 (30000 millisecondes soit 30 secondes)

• Remplacer ${PAUSEAFTERLOAD} par 1000 (1000 millisecondes soit 1 seconde)

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 fournisque vous avez téléchargés.
Dans une un invite de commande, depuis le même répertoire que les fichiers de configuration YML, lancez dans votre répertoire de travail, lancer 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 . Cela peut donc prendre quelque tempsquelques minutes. 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 la manière de résoudre les erreurs, consultez la section 'Quelques “Quelques pistes si le test ne fonctionne pas' pas” dans l'aide 'Prérequis “Prérequis à l'usage du langage GDSL' GDSL” de cette étape ou bien la documentation Greenspector.

...

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 invite de commande (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 invite de commande 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 GDSLscénario de test, 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 results>suite1>[nom_scenario]>iteration 1>screenshots.

...

Erreurs possibles

→ Dans le fichier config.yml, il faut remplacer ${PATH_TO_ADB} par le chemin de l'exécutable adb. Ecrire simplement "adb" si cette commande est déjà dans vos variables d'environnement.

→ Dans le fichier job.yml, dans le champ job.testsSuites.testFiles, indiquer le chemin de votre scénario de test.

→ Votre ordinateur est connecté en adb à plusieurs appareils. Dans un invite de commande, lancer la commande adb disconnect, puis se connecter à un seul appareil en suivant la partie “Connecter votre smartphone à votre PC via Wifi”.

→ Vérifier si le testrunner a été mis en quarantaine par votre antivirus.