/
Lancement de mesures manuelles (Android)

Lancement de mesures manuelles (Android)

Owned by Léo Chauvin
Last updated: Dec 11, 2024
3 min read

maj 11 DEC 2024

Dans cette section, vous découvrirez comment utiliser le Test Runner en mode freerunner. Celui-ci permet de lancer des étapes de mesure pour une certaine durée, pendant que vous utilisez l’application que vous voulez monitorer.

 

Préparation

Si ce n'est pas déjà fait et que vous souhaitez enregistrer des mesures sur l'interface web, créez une application sur le SaaS

  • Aller dans le portefeuille d’analyses

  • Cliquer sur Nouvelle Analyse

  • Choisir le mode “Parcours fonctionnel”

  • Saisir les informations demandées

  • Valider

 

Compléter les fichiers de configuration

  • Lancez la commande suivante pour initialiser les fichiers de configuration config.yml et job.yml :

./testrunner freerunner init

  • L’exécutable propose l’endroit où créer ces fichiers. Appuie sur la touche Entrer.

  • L’exécutable propose 2 modes de connexion (usb et wifi). Insérer le chiffre correspondant au mode que vous souhaitez, et appuyez sur la touche Entrer. Les fichiers de configuration ont été générés.

Les mesures en usb sont compliquées. Elles demandent de débrancher le câble 30 secondes avant le début de la mesure, et de le rebrancher à la fin. Privilégiez les mesures en wifi.

 

Modification du fichier config.yml

Complétez les champs suivants :

  • target:

    • serial: Identifiant du téléphone (en cas de connexion usb)

    • ip: Adresse IP du téléphone (en cas de connexion wifi)

    • paths:

      • adb: Chemin d'accès à l'exécutable adb. Ecrivez simplement "adb" si cette commande figure déjà dans vos variables d'environnement.

      • aapt: Chemin de l'exécutable aapt. Écrivez simplement "aapt" si cette commande figure déjà dans vos variables d'environnement.

  • greenspector:

  • tcpdump:

    • gatewayIP: IP de la gateway utilisée pour filtrer les données

    • networkInterface: Interface réseau utilisée pour détecter les données (wlp2s0...)

    • keepPcap: true Si true, il conserve le fichier pcap à la fin des mesures.

Allez sur Récupération des données via sonde réseau pour avoir plus de détails sur le module tcpdump et le configurer.

 

Modification du fichier job.yml

Complétez les champs suivants :

  • greenspector:

    • application:

      • name: Nom de l’application

      • version: Version testée (date, version de l'application, autre)

  • job:

    • monitoredPackages: Nom de package de l’application. Si c’est un site web, écrire "com.android.chrome".

    • stepName: Nom de l'étape de mesure

    • duration : Durée de l'étape de mesure

 

Lancement de mesures manuelles sur un appareil Android en local

  • Lancez une des commandes ci-dessous :

./testrunner freerunner start # Utilisation des paramètres du fichier job.yml ./testrunner freerunner start --duration 1m30s --stepName "Nouveau nom" # Remplacement des paramètres

  • Vous pouvez réaliser des actions manuelles sur l’appareil dès que vous voyez le message ci-dessous :

============================================== YOU CAN START YOUR MANUAL TESTS ON THE DEVICE ==============================================

  • Vous pouvez arrêter de réaliser ces actions dès que vous voyez le message ci-dessous :

 

Visualisation des résultats sur le SaaS

Il y a plusieurs points d’attention pour visualiser les résultats du freerunner sur le SaaS :

  • Chaque lancement du freerunner correspond à une étape de mesure. Pour mesurer 5 étapes, il faut donc lancer 5 fois le freerunner en modifiant la durée et le nom de l'étape. Exemple :

    • Une étape PAUSE_referenceBrowser de 30 secondes

    • Une étape CHRGT_homePage de 5 secondes

    • Une étape PAUSE_homePage de 30 secondes

    • Une étape SCROLL_homePage de 5 secondes

    • Une étape ACTION_writeText de 10 secondes

  • Pour avoir un ecoscore sur le SaaS, il faut au moins une étape commençant par “CHRGT”, “SCROLL” ou “ACTION”

  • L’ecoscore en énergie est calculé à partir d’une étape de pause de référence. Cette étape dépend du service numérique qui est mesuré :

    • Dans le cas d’une mesure d’un site web, il faut une étape PAUSE_referenceBrowser de 30 secondes au cours de laquelle le téléphone mesuré est sur la page https://dl.greenspector.com/black/index.html

    • Dans le cas d’une mesure d’une application, il faut une étape PAUSE_reference de 30 secondes au cours de laquelle le téléphone mesuré est sur l'écran d’accueil. Cet écran doit être noir si vous avez bien suivi la partie “Préparation” de cette page.

 

Si tous ces points ont été respectés, vous devriez obtenir un ecoscore valide sur le SaaS.