Lancement de mesures (Android)

maj 31 oct 2024

Dans cette section, vous découvrirez comment lancer une analyse du parcours fonctionnel sur un appareil Android local, comme cela a été décrit dans la partie « Prise en main ».

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

  • Saisir les informations demandées

  • Valider

  • Fichiers job.yml et config.yml complétés

Pour lancer les tests, l'exécutable testrunner a besoin de fichiers de configuration et de travail. Pour plus d'informations sur le contenu de ces fichiers, consultez la section Fichiers complémentaires (Android).

Modification du fichier config.yml

Editez le fichier config.yml, remplissez ou remplacez :

  • ${PHONE_IP} par l'adresse IP du téléphone

  • ${PHONE_PORT} par 5555

  • ${PRIVATE_TOKEN} par votre token. Pour trouver votre token, aller dans l'interface du SaaS, cliquer sur votre nom en haut à droite, puis cliquer sur l'onglet "Compte".

  • 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.
    ipFilters:
    apple: true

Aller 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

Editez le fichier job.yml, remplissez ou remplacez :

  • ${APP_NAME} par le nom de l'application.

  • ${APP_VERSION} par la version testée (date, version de l'application, autre).

  • Dans le champ testFiles, entrer le chemin d'accès au scénario de test.

  • ${MONITORED_PACKAGE} par le nom de package de l’application. Si c’est un site web, écrire "com.android.chrome".

  • ${PAUSEDURATION} par 1000 (1000 ms, soit 1 seconde)

  • ${PAUSEAFTERLOAD} par 1000 (1000 ms, soit 1 seconde)

  • online=true

  • skipsetupphone=false

  • tcpdump=true

  • iterations=3

 

Lancer une analyse du parcours fonctionnel sur un appareil Android local

Le lancement d'un parcours fonctionnel sur un terminal local nécessite :

  • Script GDSL

  • job.yml & config.yml

  • Smartphone connecté en adb Wifi

Rappels:

Activer ADB Wifi

  • Connecter votre appareil via le port USB

  • Vérifier la connexion ADB :

adb kill-server adb devices
  • L'appareil devrait être détecté. Une pop-up Allow USB debugging? doit apparaître sur l'appareil. Cliquer sur Allow:

  • Exécuter la commande suivante pour activer la connexion au réseau :

adb tcpip 5555
  • Débrancher le câble USB de votre appareil

  • Exécuter la commande suivante pour établir la connexion réseau :

adb connect [IP]:5555
  • Exécuter la commande suivante pour vérifier la connexion au réseau :

Vous devriez voir que votre appareil est maintenant identifié avec son IP.

Lancement de mesure

Le Testrunner est maintenant prêt à être lancé. Il suffit de le lancer pour commencer un test :

  • Aller dans le dossier où se trouvent les fichiers job et config

  • Lancer la commande suivante dans le terminal

  • Pendant l'exécution du test et jusqu'à la fin du test :

    • Ne pas fermer le terminal

    • Ne pas interagir avec l'appareil. Vérifier l'écran de l'appareil pour voir si le test est en cours.

Résultats

Le Testrunner affiche le résultat à la fin du test. En cas d'échec, la ligne d'erreur est donnée pour aider à adapter le fichier GDSL. 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.