Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Current »

Téléchargement de l'outil en ligne de commande (CLI) pour lancer les tests

Il est nécessaire de télécharger le fichier binaire “Greenspector CLI” dans la page de téléchargement pour lancer des tests. Déposez le dans un répertoire de travail de votre choix.

Pour simplifier les commandes suivantes, il est conseillé de renommer ce fichier “gspt”.

Dans la suite de la documentation, nous partons du principe que cela a été réalisé.

Initialisation de la configuration du CLI

Dans une invite de commande, placez-vous dans le répertoire de travail où vous avez téléchargé l'outil. Vous devrez rester dans le même répertoire pour le lancement des commandes à suivre.

Entrez la ligne de commande suivante :

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

Avec [MON TOKEN] , le token que vous retrouverez dans Préférence dans l’interface http://app.greenspector.com

Vérification du bon fonctionnement de l'outil CLI

L’outil Greenspector CLI (Command Line Interface) vous permet, depuis une invite de commande, d’interagir avec les services de calcul de l’écoscore et le banc de mesure distant, notamment en lançant des mesures de votre application sur des terminaux réels. Dans une invite de commande, entrez la ligne de commande suivante. Si la mention “Server pinged with success” s'affiche, alors la configuration est correcte. Sinon, merci de contacter le support.

./gspt ping

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 : https://app.greenspector.com/download > GDSL Templates : Download (vous pouvez choisir entre un fichier de test pour une application Android, un site web, ou une application iOS).

Une fois téléchargé, déplacez le fichier de scénario de test dans le répertoire du CLI. Si vous avez déjà téléchargé un fichier GDSL pour une autre application ou une autre version, il est nécessaire de placer ce fichier dans un nouveau répertoire ou alors de le renommer.

Configuration du profil de l'application

Cette commande, à lancer dans l’invite de commande, va permettre de configurer le nom de l'application à mesurer et sa version. 

./gspt initprojectconfiguration --application "[Nom de l'application']" --version "[Version]"

Avec [Nom de l’application] : Nom que vous retrouverez dans l’interface

[Version] : Nom de la version pour suivre vos différentes mesure

Sélection du smartphone de mesure

Les tests vont être lancés sur un smartphone réel, mis à disposition depuis notre banc de mesure. Cette commande va permettre de choisir le modèle de smarphone sur lequel le scénario sera exécuté.

./gspt testbench set-environment

Si vous connaissez déjà la référence du device, vous pouvez l’entrer directement de cette manière!

./gspt testbench set-environment -e "mobile::Android::10::Samsung - Galaxy S9"

Lancement d’une mesure web sur le banc de mesure

La ligne de commande ci-dessous permet de lancer une mesure rapidement (les temps de mesure sont réduits).

./gspt testbench custom-tests --testsSuite launch:./script.testgb --monitoredPackage "com.android.chrome" --iterations=1 -e config-skipsetupphone=true --networkMode=Wifi --disable-dumpsys -e PAUSEDURATION=1000 -e PAUSEAFTERLOAD=1000

Vous pouvez à cette étape expérimenter le lancement d’un test de benchmark lancé précédemment via l’interface mais en ligne de commande. Pour cela vous pouvez utiliser une commande du type

gspt testbench measure-url --help

Lancement d’une mesure d’application sur le banc de mesure

Par rapport aux mesures web, il faut modifier l’option “monitoredPackage” avec le nom du package de l’application.

Il faut aussi ajouter l’option “apkFile” de la manière suivante :

  • Si l’application est présente sur Play Store :

--apkFile [nom du package de l’application] # ex : --apkFile com.google.android.youtube

  • Si l’application est présente avec un apk local : 

-apkFile [path vers l’apk] # ex : --apkFile ./mon_apk.apk

  • Si l’application est présente avec un apk public : 

--apkFile [path vers l’apk] # ex : --apkFile https://mon-site.com/mon-apk.apk

La ligne de commande ci-dessous permet de lancer une mesure rapidement (les temps de mesure sont réduits) : 

./gspt testbench custom-tests --testsSuite launch:./script.testgb --monitoredPackage [appPackageName] --iterations=1 -e config-skipsetupphone=true --networkMode=Wifi --disable-dumpsys -e PAUSEDURATION=1000 -e PAUSEAFTERLOAD=1000 --apkFile [appPackageName]

Vous pouvez à cette étape expérimenter le lancement d’un test de benchmark lancé précédemment via l’interface mais en ligne de commande. Pour cela vous pouvez utiliser une commande du type

gspt testbench benchmark-apk --help

Suivi de l'avancement des tests

Les tests peuvent prendre du temps (30 minutes à 24 heures). Vous recevrez un mail dès que la mesure sera finalisée. Un mode local est disponible pour la mise au point des scripts de test et permet de réduire ce délai d'attente (Description pour ce mode opératoire local dans les étapes suivantes).

Si passé le délais de 24 heures, vous n’avez toujours pas reçu de mail de notification, ni aucun résultat sur le portail, une erreur s’est peut-être produite sur le banc de mesure. Merci d’essayer de relancer votre mesure ou de contacter le support.

  • No labels