Fichiers complémentaires (IOS)

Le TestRunner a besoin de fichiers de travail et de fichiers de configuration pour exécuter les tests. Ils se trouvent dans la section Modules/Testrunner/Template de Greenspector App.

Règles de style :

Gras : paramètres contenant une valeur
Italique : pas de libre choix de valeur (ex : false/true)

1 - Job.yml

Le fichier job.yml donne les instructions au TestRunner sur les détails du parcours (variables, itérations).

Ici, il y a le modèle de fichier pour le test iOS disponible dans la section Modules/Testrunner/Job pour iOS dans l'application Greenspector.

Les différentes lignes de code sont expliquées ci-dessous.

mode: custom
greenspector:
  application:
    name: ${APP_NAME} # Le nom de votre application
    version: ${APP_VERSION} # La version de votre application

mode:
- custom: tester avec le script GDSL
greenspector/application
- name : le nom de l'application Greenspector App
- version : le nom de la version

job:
  # Liste de tous les ipa obligatoires à installer sur le téléphone avant le lancement du test
  # App peut être le path vers l'Apple Store, le chemin local d'un ipa ou l'URL publique d'un ipa
  # apps:
  #   - ${app}
  testsSuites:   
    - name: suite1
      testFiles:
        - "./script.testgb"
  iterations: 1 # Nombre d'itérations pour chaque cas de test
  extras:
    PAUSEDURATION: "${PAUSEDURATION}"
    PAUSEAFTERLOAD: "${PAUSEAFTERLOAD}"
  testTimeout: 30m0s # Délai d'attente pour la durée totale du test, la valeur par défaut est de 30 m, la valeur maximale est de 60 m.
  online: true # [true, false]
  modules:
    hardware_probe: false
    tcpdump: false

testsSuites
- name: le nom de l’application
- testFiles: le chemin du fichier du parcours fonctionnel

iterations: Nombre d’itérations pour chaque cas de test
extras :
- PAUSEDURATION
- PAUSEAFTERLOAD

testTimeout: Délai d'attente pour la durée totale du test, la valeur par défaut est de 30 m, la valeur maximale est de 60 m.
online:
- false : résultats disponibles sur votre PC
- true : résultats disponibles sur l'application Greenspector et localement

modules
- hardware_probe: “false” (utilisation du module matériel pour obtenir la consommation d'énergie)
- tcpdump: “false” (utilisation du module tcpdump pour obtenir les données échangées)

Des extras peuvent être ajoutés :

PAUSEAFTERACTION: 500
PAUSEAFTERSCROLL: 500
Variables nécessaires (id, mot de passe, ...)

Example

# Fichier de configuration du Testrunner
mode: custom
greenspector:
  application:
    name: LeMonde
    version: "automatisation"

job: # Custom job android apk
  testsSuites:
    - name: "LeMonde"
      testFiles:
        - ios.testgb
  iterations: 1
  testTimeout: 60m0s
  online: false
  modules:
    hardware_probe: false
    tcpdump: false
  extras:
    PAUSEDURATION: 2000
    PAUSEAFTERLOAD : 1000
    PAUSEAFTERACTION: 500
    PAUSEAFTERSCROLL: 500
    ID: jean
    PSWD: 5678

2 - Config.yml

Le fichier config.yml fournira au testrunner les informations relatives à l'appareil et à la connexion au serveur.

Ici, il y a le modèle de fichier pour le test iOS disponible dans la section Modules/Testrunner/Config pour iOS dans l'application Greenspector.

Les différentes lignes de code sont expliquées ci-dessous.

platform: ios # La plateforme sur laquelle vous testez [mobile | pc]
resultPath: ./greenspector # Le chemin où vous voulez que le Testrunner enregistre les résultats des tests. La valeur par défaut est ./greenspector/measures
target: # bloc cible pour le mode iOS
  connection: usb
  udid: ${PHONE_UDID} # Identifiant unique de l'iPhone
  name: ${PHONE_NAME} # Nom de l'iPhone
greenspector:
  server: ${GREENSPECTOR_CORE_SERVER_URL} # URL de votre instance Greenspector
  token: ${PRIVATE_TOKEN} # Votre token privé enregistré sur Greenspector

plateform: La plateforme sur laquelle vous testez (ios)
resultPath: Le chemin où le Testrunner enregistre les résultats des tests. La valeur par défaut est ./greenspector/measures.
udid: Identifiant unique de l'iPhone (vous pouvez le trouver dans Xcode > Window > Devices and Simulators)
name: Nom de l'iPhone. Par exemple, vous pouvez choisir la version de votre iPhone (ex : iPhone 14).
greenspector/server: URL de l'instance Greenspector(https://app.greenspector.com)
greenspector/token: Token privé enregistré sur Greenspector dans Profil/Préférences

Des paramètres peuvent être ajoutés :

log-level: Le niveau de log que vous souhaitez (de maximum à minimum)
- debug
- info
- warn
- error
- fatal
- panic

Des paramètres cibles peuvent être ajoutés :

target:
  # Pour le module hardware_probe dans le fichier job.yml
  hardware:
    address: /dev/ttyACM0
  # Pour le module tcpdump dans le fichier job.yml
  tcpdump:
    deviceIP: 10.42.0.129       # IP de l'iPhone à mesurer
    gatewayIP: 10.42.0.1        # IP de la passerelle utilisée pour filtrer les données
    networkInterface: wlp2s0    # Interface réseau utilisée pour détecter les données (wlp2s0...)
    keepPcap: false           	# Si true, il conserve le fichier pcap à la fin des mesures.
    ipFilters:                  # Autres adresses IP utilisées pour filtrer les données
      apple: false              # Si true, il filtre les données relatives à 17.0.0.0/8.

Pour plus d'informations sur le module tcpdump, voir : Récupération des données via sonde réseau

Exemple

log-level: debug
platform: ios
resultPath: ./results
target:
  connection: usb
  udid: 00008110-001969180AA8201E
  name: "iPhone"
  hardware:
    address: /dev/cu.usbmodem11401
  tcpdump:
    deviceIP: 192.168.2.4
    gatewayIP: 192.168.2.1
    networkInterface: bridge100
    ipFilters:
      apple: true
greenspector:
  server: https://app.greenspector.com
  token: ******************************

L'indentation est importante dans ces fichiers, prêtez y attention.