| Status | ||||
|---|---|---|---|---|
|
| Info |
|---|
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 Examples du Gitlab Greenspector. |
...
| Info |
|---|
Le fichier job.yml donne les instructions au TestRunner sur les détails du parcours (variables, itérations). |
Ici, il y a le Le modèle de fichier pour le test iOS est disponible dans la section Modules/Testrunner/Job Examples pour iOS dans l'application le Gitlab Greenspector.
Les différentes lignes de code sont expliquées ci-dessous.
...
mode:
custom: tester avec le script GDSLapp: benchmark à partir d’un APK (ex: com.google.ios.youtube)
url: benchmark à partir d’une URL (ex: https://metropole.nantes.fr)
greenspector/application
name : le nom de l'application dans Greenspector AppStudio
version : le nom de la version
| Code Block | ||
|---|---|---|
| ||
job: # Liste de tous les apkipa obligatoires à installer sur le téléphone avant le lancement du test # L'URLApp peut être le nompath duvers paquet à installer depuis le Playstorel'Apple Store, le chemin local d'uneun apkipa ou l'URL publique d'uneun apkipa # urlsapps: # - ${URLapp} testsSuites: - name: suite1 testFiles: - "./script.testgb" monitoredPackages: - ${MONITORED_PACKAGE} # Le package à surveiller, existant ou nouvellement installé iterations: 1 # Nombre d'itérations pour chaque cas de test extras: config-screenbrightness: "127" config-skipsetupphone: "true" 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] networkMode: WIFI modules: hardware_probe: false tcpdump: false |
testsSuites
name: le nom de l’application
testFiles: le chemin du fichier du parcours fonctionnel
monitoredPackages: app package
...
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 Studio 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)
...
| Info |
|---|
Le fichier config.yml fournira au testrunner les informations relatives à l'appareil et à la connexion au serveur. |
Ici, il y a le Le modèle de fichier pour le test iOS est disponible dans la section Modules/Testrunner/Config Examples pour iOS dans l'application le Gitlab Greenspector.
Les différentes lignes de code sont expliquées ci-dessous.
| Code Block | ||
|---|---|---|
| ||
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 ipconnection: ${PHONE_IP}usb udid: ${PHONE_UDID} # Identifiant unique name: ${PHONE_NAME}de l'iPhone langname: ${PHONE_LANGUAGE} paths: webDriverAgent: /usr/local/lib/node_modules/appium-webdriveragent/WebDriverAgent.xcodeproj # Chemin complet vers WebDriverAgent xcodeproject ios-deploy: /usr/local/bin/ios-deploy # Chemin d'accès à ios-deploy. Laissez ce champ vide si ios-deploy se trouve dans votre PATH.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.ip: adresse IP de l’iPhone
udid: Identifiant unique de l'iPhone (vous pouvez le trouver dans Xcode > Window > Devices and Simulators)
name: Nom de l'iPhone (vous pouvez le trouver dans Xcode > Window > Devices and Simulators)
lang: “en” pour l’anglais, “fr” pour le français
paths
webDriverAgent: Chemin complet vers WebDriverAgent xcodeproject
ios-deploy: Chemin d'accès à ios-deploy. Laissez ce champ vide si ios-deploy se trouve dans votre PATHgreenspector/server: URL de l'instance Greenspector(https://appcore-saas-prod.greenspector.com/)
greenspector/token: Token privé enregistré sur Greenspector dans Profil/Préférences
. Par exemple, vous pouvez choisir la version de votre iPhone (ex : iPhone 14).
...
| Code Block | ||
|---|---|---|
| ||
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.
launchOnDevice: false # Si true, il lance tcpdump sur le terminal. |
Pour plus d'informations sur le module tcpdump, voir : Récupération des données via sonde réseau
...
| Code Block | ||
|---|---|---|
| ||
log-level: debug platform: ios resultPath: ./results target: ipconnection: 192.168.2.4usb udid: 00008110-001969180AA8201E name: "iPhone" langhardware: fr paths: webDriverAgent address: /opt/homebrew/lib/node_modules/appium-webdriveragent/WebDriverAgent.xcodeproj ios-deploy: /usr/local/bin/ios-deploy hardwaredev/cu.usbmodem11401 tcpdump: addressdeviceIP: /dev/cu.usbmodem11401 tcpdump:192.168.2.4 gatewayIP: 192.168.2.1 networkInterface: bridge100 ipFilters: apple: true greenspector: server: https://appcore-saas-prod.greenspector.com/ token: ****************************** |
...