/
Mesure sur le Testbench

Mesure sur le Testbench

MAJ 28 MAR 2025

Votre script a été mis au point, il est valide.

Vous pouvez maintenant passer à l’exécution des mesures finales !

Exécuter un parcours fonctionnel

Lancer la mesure via l'éditeur web

  • Cliquer sur le bouton Lancer.

image-20251029-091522.png

  • Une fenêtre s’ouvre sur la configuration des mesures

image-20251029-091419.png

  • Sélectionner le mode de mesure Final.

  • Créer une nouvelle version propre aux mesures finales : celle ci peut être la date du jour, la version du service numérique ou autre.

image-20251029-091726.png

  • Choisir ensuite le terminal sur lequel effectuer la mesure. Il doit être le même que celui utilisé durant la mise au point

  • Indiquer 3 itérations de mesure minimum pour fiabiliser les résultats

  • Cliquer sur > Lancer

Lancer une mesure via le CLI

Initialisation de la configuration

  • Windows/Linux/Mac:

gspt init --greenspectorApi "https://core-saas-prod.greenspector.com/api" --privateToken [MON-TOKEN]

Quel que soit votre système d'exploitation, veuillez remplacer [MON-TOKEN] par un token personnel.

Il se trouve dans Greenspector Studio :

  • Cliquez sur le nom du compte en haut à droite

  • Choisissez Compte

gspt ping

Il faut lier le Greenspector CLI avec l’analyse sur Greenspector Studio.

gspt initprojectconfiguration --application [NOM-APP] --version [VERSION]

Veuillez remplacer [NOM-APP] et [VERSION] avec les informations utilisées dans la section précédente.

Définir l'environnement

Pour utiliser la commande testbench, vous devez d'abord définir l'environnement de votre projet.
Pour ce faire, vous devez utiliser cette commande :

gspt testbench set-environment

Saisissez le numéro de votre choix :

Available environments: 1 - mobile: Samsung - Galaxy S7 with android 8 2 - mobile: pixelc with android 8.1.0 3 - mobile: Samsung - Galaxy S9 with android 10 4 - mobile: Samsung - Galaxy S9 - with sim with android 10 5 - mobile: Samsung - Galaxy S9 - Maintenance with android 10 6 - mobile: Samsung - Galaxy S22 with android 13 7 - mobile: Samsung - Galaxy Tab S7 FE with android 13 8 - mobile: Samsung - Galaxy S10 with android 12 9 - mobile: Samsung - Galaxy S10 - with sim with android 12 Please choose an environment:

Lancement d'une mesure web sur le Test bench

Voici un exemple de ligne de commande ci-dessous pour lancer une mesure.

gspt testbench custom-tests --testsSuite launch:./script.testgb --monitoredPackage "com.android.chrome" --iterations=3 -e config-skipsetupphone=false --networkMode=Wifi -e PAUSEDURATION=30000 -e PAUSEAFTERLOAD=1000

Lancement d'une mesure d’application sur le Test bench

Pour les mesures web, l'option monitoredPackage doit être modifiée avec le nom du paquet de l'application.

Vous devez également ajouter l'option app comme suit :

  • Si l'application est disponible sur Play Store (Android) ou sur Apple Store (iOS) :

--app [package name of app] # ex : --app com.google.android.youtube --app [url of the app on Apple Store] # ex: --app https://apps.apple.com/fr/app/youtube/id544007664

  • Si l'application est présente avec un apk local (Android) ou un ipa local (iOS) :

--app [path to the apk] # ex : --app ./my_app.apk --app [path to the ipa] # ex : --app ./my_app.ipa

  • Si l'application est présente avec un apk public (Android) ou un ipa public (iOS) :

--app [path to the apk] # ex : --app https://my-website.com/my-app.apk --app [path to the ipa] # ex : --app https://my-website.com/my-app.ipa

Voici un exemple de ligne de commande ci-dessous pour lancer une mesure.

gspt testbench custom-tests --testsSuite launch:./script.testgb --monitoredPackage [appPackageName] --iterations=3 -e config-skipsetupphone=false --networkMode=Wifi -e PAUSEDURATION=30000 -e PAUSEAFTERLOAD=1000 --app [appPackageName]

 

Option obligatoire *

  • --app: apk ou ipa à mesurer. Le fichier peut être un chemin local, une URL publique, un nom de paquet à télécharger depuis le PlayStore ou une url de l’application à télécharger depuis l’Apple Store. Préférez des fichiers séparés pour votre application et pour vos tests.

  • --testsSuite* : Nom du script écrit en GDSL. Si plusieurs scripts, tous les fichiers de test seront lancés dans l'ordre spécifié.

  • --monitoredPackage* : Nom du paquet android. Les sondes peuvent surveiller plusieurs paquets à la fois. Dans ce cas, les métriques sont agrégées. Pour un site web, choisissez com.android.chrome.

  • --iterations: Nombre d'itérations de mesure souhaitées. (Par défaut : 1).

  • --report: Génère automatiquement le rapport de test dans le dossier .greenspector et attend la fin de la tâche (par défaut : false). Cette commande envoie une demande de mesure au serveur. Après l'exécution de cette mesure sur le Testbench, vous trouverez les résultats sur l'interface Web.

  • --extra: A utiliser pour transmettre des paramètres supplémentaires au format nom=valeur. (exemple --e PARAMETERNAME="valeur" remplaceront toutes les variables ${nomParametre} dans le fichier GDSL par valeur).

  • --networkMode: Le mode de réseau pour le test. Les valeurs peuvent être « WIFI », « 4G », « 3G » ou « 2G ». (Valeur par défaut : WIFI).

  • --disable-dumpsys: Désactive la surveillance du système Android. Par défaut, cette option est activée et ajoutera une itération à votre travail pour des mesures plus détaillées (Vues, Activité, Sockets OpenSSL, ...). Si vous n'avez pas besoin de ces mesures, désactivez cette itération, cela réduira le temps de test.

  • --only-dumpsys: Lance uniquement une itération de surveillance du système Android. Cette itération ne pourra récupérer que les métriques du système Android (Vues, Activité, Sockets OpenSSL, ...).

Pour lancer les mesures finales, il faut veiller à ces paramètres dans le fichier job.yml :

  • iterations: 3

  • config-skipsetupphone: false

  • PAUSEDURATION: 30000

  • PAUSEAFTERLOAD: 1000

A noter que les extras dans job.yml qui contiennent du texte, comme PSWD par exemple, ne peuvent pas contenir de « ! » car ils sont interprétés par le bash.

 

Résultats

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.

https://greenspectorstudio.atlassian.net/wiki/spaces/DPP/pages/275906562/Lancer+les+tests+GDSL+avec+l+API+Greenspector+Studio+dans+Gitlab+CI?atlOrigin=eyJpIjoiN2FkNjMwNWNlNzA1NGNjMGE2NTUzOGZiMDNhYTc4ZGYiLCJwIjoiYyJ9

 

Attendre les résultats

Après avoir appuyé sur Lancer, le test entre dans la file d’attente des tests à exécuter. Il affiche d’abord un message de d’attente puis de mesure en cours lorsqu’il est en cours d’exécution sur un appareil.

image-20251029-092153.png
image-20251029-093344.png

Lorsque l’exécution est terminée, le rapport du test vous indique l'état de celui ci, s’il est en succès ou non et l’erreur associée dans ce cas.

image-20251029-093915.png

Si le test n'aboutit pas, consultez la rubrique https://greenspectorstudio.atlassian.net/wiki/spaces/DPP/pages/116392017

Si le test est réussi, félicitations !

Vérifiez la cohérence des mesures avec https://greenspectorstudio.atlassian.net/wiki/spaces/DPP/pages/116719808