Page Comparison

• Windows/Linux/Mac:

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

gspt ping

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

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

gspt testbench set-environment

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:

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

--app [package name of app] # ex : --app com.google.android.youtube

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

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

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

Option obligatoire *

• --app: Précisez les APKs que vous voulez mesurer et les APKs qui contiennent vos tests fonctionnels à lancer. Préférez des APKs séparés pour votre application et pour vos tests. apkFile: APK à mesurer. Le fichier apk peut être un chemin local, une URL publique ou un nom de paquet à télécharger depuis le PlayStore. Préférez des APKs séparés pour votre application et pour vos tests.

• --testsSuite* : Nom du script Gdsl et listes des fichiers de test écrits avec Greenspector DSL. Tous é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 le un site web, choisissez le navigateur dans lequel les tests s'exécutent (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 Power Test Bench/CloudTestbench, vous trouverez les résultats sur l'interface Web.

• --extra: A utiliser pour transmettre des paramètres supplémentaires au format nom=valeur. (exemple --extra e PARAMETERNAME="valeur" remplaceront toutes les variables ${PARAMETERNAMEnomParametre} 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: Lancer 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.

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

• Premièrement, cliquer sur Benchmark dans le menu latéral :

• Choisir + Ajouter une application, entrer un nom et valider. Le champ de description est optionnel.

• Choisir + Ajouter une version, et donner un nom de version :

• Choisir un environnement de test. La liste montre les appareils disponibles sur notre banc d'essai :

• Spécifiez le type d'élément à mesurer : Site web ou Application mobile

• Pour le site web, entrez l'URL d'un site web

• Pour l'application, entrez :

  • Un lien vers le fichier .apk

  • Un nom de paquet qui sera téléchargé sur Google Playstore

• Entrer le nombre de fois que le benchmark doit être exécuté :

  • Plus le nombre est élevé, meilleure est la précision, mais plus long est le temps d'exécution.

• Pour un site web, indiquer le navigateur à utiliser

Suivre le processus de mesure

L'onglet Test tracking permet de vérifier si le test est pris en compte par le testbench :

• En Pending, le test est en attente d'un appareil disponible dans le testbench

• Lorsqu'il est Running, le test est en cours d'exécution sur un appareil

• Lorsqu'il est Finished, les résultats sont disponibles

Le temps d'attente dépend de la disponibilité des appareils du testbench.

A la fin, cliquez sur le test pour obtenir plus d'informations, comme des logs, des captures d'écran ou des dumps. Elles restent disponibles pendant 7 jours.

Vérifier que toutes les règles ont été évaluées : 24 règles doivent être vérifiées.

Si ce n'est pas le cas, relancer le benchmark.

Pour utiliser cette fonctionnalité, vous devez d'abord configurer le nom de l'application, sa version et l'environnement sur lequel la mesure doit être exécutée.
La commande à exécuter est la suivante :

gspt testbench measure-url --url [URL]

Options

Option obligatoire*

• --url* : l'URL à benchmark

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

• --browser: Navigateur sur lequel la mesure doit être exécutée. (Par défaut : Google Chrome).

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

• --report: Génère automatiquement le rapport de test dans le dossier .greenspector et attend la fin du travail. (Valeur par défaut : false).

Cette commande envoie une demande de mesure au serveur. Après l'exécution de cette mesure sur le Test Bench, les résultats sont disponibles sur l'interface web.

Exemples

gspt testbench measure-url --url https://greenspector.com/ 
gspt testbench measure-url --url https://greenspector.com/ --iterations 5 --browser chrome --networkMode 4G 
gspt testbench measure-url --url https://www.mozilla.org/fr/ --browser firefox --report

Pour utiliser cette fonctionnalité, vous devez d'abord configurer le nom de l'application, sa version et l'environnement sur lequel la mesure doit être exécutée.
La commande à exécuter est la suivante :

gspt testbench benchmark-apk --appapkFile [APK-PATH]

Options

Option obligatoire*

• --appapkFile* : APK(s) à comparer. (S'il est défini plusieurs fois, tous les APK seront installés, mais seul le premier sera lancé et surveillé). Il peut s'agir d'un chemin local, d'une URL publique ou d'un nom de paquet à télécharger depuis le PlayStore. Facultatif si les applications à évaluer sont déjà installées sur le téléphone.

• --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 du travail. (Valeur par défaut : false).

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

Cette commande envoie une demande de mesure au serveur. Après l'exécution de cette mesure sur le Test Bench, vous trouverez les résultats sur l'interface Web.

Exemple

gspt testbench benchmark-apk --appapkFile target/final.apk # local path to apkgspt testbench benchmark-apk --appapkFile https://demo/demo.apk # apk from public urlgspt testbench benchmark-apk --appapkFile com.microsoft.office.outlook # package name to download the apk from the PlayStoregspt testbench benchmark-apk --appapkFile target/main.apk --appapkFile target/app-module.apk --appapkFile target/commons.apk --networkMode 3G # three apk to install and launch benchmark in 3Ggspt testbench benchmark-apk --appapkFile target/final.apk --iterations 5 --report # Launch 5 iterations of the benchmark and wait for the report