Pré-requis

• Configurer le téléphone pour exécuter les tests : Settings > Developer > cocher « Enable UI Automation »

• Télécharger l’environnement de développement pour macOS Xcode (disponible sur App Store)

• Disposer de versions compatibles de Xcode, macOS et iOS : https://developer.apple.com/fr/support/xcode/ (éviter la version 13.3.1 d’iOS)

Pour tester un téléphone avec iOS 15.4, il est nécessaire d’avoir Xcode 13.3 et un macOS 12.3 Monterey. Cette version de macOS est disponible sur les MacBook Pro commercialisés à partir de 2015. Elle permet également de tester les téléphones ayant une version d’iOS antérieure.

Etape 1 : Installation du WebDriverAgent

WebDriverAgent est un serveur WebDriver initié par Facebook puis repris par Appium pour automatiser des actions utilisateur sur les appareils iOS. Ce projet constitue la base de notre solution d’automatisation.

...

Le projet Xcode se trouve alors dans le répertoire node_modules : [NPM_ROOT_PATH]/appium-webdriveragent/WebDriverAgent.xcodeproj

Il faut remplacer NPM_ROOT_PATH par le résultat de la commande npm root -g.

Exemple : /usr/local

• Résultat de la commande npm root -g : /opt/homebrew/lib/node_modules

• Path du projet Xcode : /opt/homebrew/lib/node_modules/appium-webdriveragent/WebDriverAgent.xcodeproj

Etape 2 : Préparation du WebDriverAgent sur Xcode pour la première utilisation

• Ouvrir un terminal et aller où se trouve le projet :

cd /usr/local/lib/node_modules[NPM_ROOT_PATH]/appium-webdriveragent/

• Ouvrir le projet :

...

• Faire les mêmes actions en sélectionnant IntegrationApp parmi les targets.

• Dans le choix de la cible en haut de Xcode, choisir WebDriverAgentRunner et le bon téléphone.

...

Etape 3 : Installation du WebDriverAgent sur le téléphone [Commencer directement à cette étape si Xcode est déjà configuré]

• Compiler le projet : Product > Build

• Lancer le WebDriverAgent (WDA) : Product > Perform Action > Test Without Building
  Le WDA est installé sur le téléphone. On s’attend à une erreur car le développeur n’est pas identifié sur le téléphone. On l’autorise à partir de l’iPhone : Settings > General > Device management. On relance le test depuis Xcode : Product > Perform Action > Test Without Building. Le WebDriverAgent est alors prêt à recevoir des requêtes pour l’automatisation

• Arrêter le test en cliquant sur l’icône carré.

...

Etape

...

4 : Lancement du WebDriverAgent à partir du testrunner

• Récupérer le testrunner sur https://app.greenspector.com, dans l’onglet Modules, et le placer dans un dossier (par exemple “testrunner_files”).

• Ajouter dans ce dossier les fichiers de configuration config_ios.yml et job_ios.yml, ainsi qu'un script gdsl avec l’extension “testgb”.

• Modifier ces fichiers pour qu’ils correspondent à la mesure souhaitée.

Exemple d’un fichier config_ios.yml :

platform: ios # The platform you are testing on [mobile | pc]
resultPath: ./greenspector # The path where you want the Testrunner to save the tests results. defaults to ./greenspector/measures
target: # target bloc for iOS mode
  ip: 192.168.10.52 #Olivier’s iPhone
  udid: 42df71bb47bb61cca72559672128f1fbb5184a62 #Olivier’s iPhone
  name: Olivier's iPhone
  lang: en
  paths:
    webDriverAgent: /usr/local/lib/node_modules/appium-webdriveragent/WebDriverAgent.xcodeproj # Full path to WebDriverAgent xcodeproject
    ios-deploy: /usr/local/bin/ios-deploy # Path to ios-deploy. Leave this empty if ios-deploy is in your PATH
greenspector:
  server: https://app.greenspector.com # URL of your Greenspector instance
  token: XXXXX # Your private token registered on Greenspectors

Le champ udid correspond à l'identifiant unique de l'appareil, trouvable grâce à Xcode (Window > Devices and Simulators).

Exemple d’un fichier job_ios.yml :

mode: custom # apk | url | custom
greenspector:
  application:
    name: TestLeo # Your application's name
    version: "REFERENCE (iOS)" # Your application's version
job: # Custom job android apk
  testsSuites:   
    - name: suite1
      testFiles:
        - "./testreference.testgb"
  iterations: 1 # Number of iteration for each test case
  testTimeout: 30m0s # Timeout for the total duration of the test, default value is 30m, max value is 60m
  online: true # [true, false]
  modules:
    hardware_probe: false

Exemple de d’un script gdsl simple gdsl testant l’application YouTube :

#Lancement de l'application
measureStart,CHRGT_homePage
applicationStart;,com.google.ios.youtube
waitUntilText,Home
pause;5000
measureStop;LAUNCHYT
measureStart
pause;30000
measureStop;PAUSEYT,1000
measureStop

#Pause sur la page d’accueil
measureStart,PAUSE_homePage
pause,30000
measureStop

#Ecriture de la recherche
measureStart,ACTION_writeResearch
clickByTextExact,Search
enterText,greenspector
measureStop

#Recherche d'une vidéo
measureStart,CHRGT_videos
clickByTextExact,Search
waitUntilText,Home
pause,1000
measureStop

#Arrêt de l’application
applicationKill,com.google.android.youtube

Pour trouver l’identifiant des applications installées sur le téléphone, taper la commande “ios-deploy -B”.

...

• Ouvrir un terminal à l’intérieur de ce dossier

• Autoriser l’exécution du testrunner

chmod +x testrunner

• Lancer le testrunner :

./testrunner --jobFile job_ios.yml --config config_ios.yml

Outils pour inspecter les applications et les sites web sur iOS

• Appium Desktop Server GUI : https://github.com/appium/appium-desktop

• Appium Inspector : https://github.com/appium/appium-inspector

...

• Ouvrir le projet WebDriverAgent sur Xcode

• Lancer l’automatisation : Product > Perform Action > Test Without Building

• Ouvrir Appium DesktopServer GUI

• Cliquer sur “Start Server”

• Ouvrir Appium Inspector

• Compléter le champ “Remote Path” : /wd/hub

• Compléter le champ “Json Representation” avec les informations relatives à votre téléphone :

...

Sur Appium Inspector, l'écran du téléphone apparaît. Il est alors possible de sélectionner les éléments de l'écran pour visualiser leurs informations (name, label…), mais aussi de réaliser directement des scrolls et des clics. Les fonctions du type clickByText, searchByText, waitUntilText et setTextByText recherchent le label des éléments, puis le name.

Documentation du GDSL sur iOS

Une documentation commune pour Android et iOS est en cours d'élaboration.Voir Greenspector DSL for iOS

Erreurs possibles

...

→ Désinstaller le WebDriverAgent sur le téléphone, et le réinstaller en suivant la procédure habituelle (Voir la fin de l'étape 2 à partir de la compilation du projet3).

...