/
Mesure sur le Testbench

Mesure sur le Testbench

status:maj 28 MAR 2025

Exécuter un parcours fonctionnel

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.

Si le test n'aboutit pas, consultez la rubrique Résolution de problèmes (mesures)

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

Vérifiez la cohérence des mesures avec Vérification de la cohérence des mesures