Greenspector Documentation has been moved.
Please go to
https://greenspectorstudio.atlassian.net/l/cp/TDhqYDSu

Lancer un script gdsl avec le testrunner sur iOS (sans mesure physique) 

Owned by Guillaume SUSSELIN
Last updated: 19 Sept 2024 by Maeva Rondeau
7 min read
Redirection

Pré-requis

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.

L’installation se fait grâce à npm :

brew update brew install node npm install --global appium-webdriveragent

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 :

  • 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 [NPM_ROOT_PATH]/appium-webdriveragent/

  • Ouvrir le projet :

open WebDriverAgent.xcodeproj

  • Connecter le téléphone au Mac en filaire.

  • Connecter le téléphone et le Mac au même réseau wifi.

  • Window > Devices and Simulators : cliquer sur le nom de son iPhone et cocher la case "connect via network" (une icône “planète” doit apparaître à côté du nom du téléphone, si cela ne fonctionne pas plusieurs fois, désactiver et réactiver le wifi du Mac).

  • Une fois la connexion faite, retirer le câble entre l'iPhone et le Mac.

  • Dans le navigateur de projet à gauche dans Xcode, cliquer sur “WebDriverAgent”.

  • Sélectionner WebDriverAgentRunner parmi les targets, et l’onglet “Signing & Capabilities”.

  • Vérifier que le champ “Automatically manage signing” est coché.

  • Sélectionner une équipe de développement. On peut utiliser l’équipe Greenspector ou l’équipe associée à son identifiant Apple, comme sur l’exemple. On s’attend à une erreur au niveau du bundle identifier (package name) car celui-ci est déjà utilisé.

  • Basculer sur l’onglet “Build Settings” et renseigner un nouveau bundle identifier dans la section Packaging.

  • La section “Signing & Capabilities” est alors mise à jour.

  • 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é]

Vérifier si la connexion se fait automatiquement entre le téléphone et le Mac dans Xcode > Window > Devices and Simulators. Une icône “planète” doit apparaître à côté du nom du téléphone.

Si ce n’est pas le cas :

  • Connecter le téléphone au Mac en filaire.

  • Connecter le téléphone et le Mac au même réseau wifi (possibilité de faire un partage de connexion du Mac vers le téléphone).

  • Window > Devices and Simulators : cliquer sur le nom de son iPhone et cocher la case "connect via network". Une icône “planète” doit apparaître à côté du nom du téléphone. Si cela ne fonctionne pas plusieurs fois, désactiver et réactiver le wifi du Mac.

  • Une fois la connexion faite, retirer le câble entre l'iPhone et le Mac.

  • 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 :

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 :

 

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

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

Pour transférer des fichiers .ipa de l’ordinateur vers le téléphone, télécharger le fichier binaire ideviceinstaller (https://github.com/libimobiledevice/ideviceinstaller ), puis taper la commande “ideviceinstaller --install [path_to_ipa_file]”.

 

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

  • Lancer le testrunner :

 

Lors du 1er lancement du testrunner, il est nécessaire d’autoriser son exécution :

  • Lancer la commande chmod +x testrunner

  • Cliquer sur la pomme, puis sur System Settings > Privacy & Security > Allow anyway

 

Outils pour inspecter les applications et les sites web sur iOS

Démarche à suivre :

  • Ouvrir le projet WebDriverAgent sur Xcode

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

  • Ouvrir Appium Server 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 :

  • Cliquer sur “Start Session”

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

Voir Greenspector DSL for iOS

 

Erreurs possibles

A test configuration must be provided to _XCTestMain” sur Xcode

→ Problème du WebDriverAgent avec la version 13.3.1 de iOS. Mettre à jour le téléphone.

 

→ Il faut simplement réinsérer le câble de l’iPhone sur un autre port.

 

→ Désinstaller le WebDriverAgent sur le téléphone, et le réinstaller en suivant la procédure habituelle (Voir l'étape 3).

 

→ Il s’agit d’un problème de connexion entre le téléphone et l’ordinateur. Vérifier sur Xcode dans “Window > Devices and Simulators” si le téléphone est toujours connecté.

 

→ Vérifier l’adresse IP renseignée dans le fichier config.yml.

 

→ Relancer les mesures.

 

→ Exemple d’échec de commande GDSL. Relancer les mesures dans ce cas.