Local iOS Devices

Configuration des appareils iOS locaux

Pour configurer un appareil local pour qu’il fonctionne avec les activités d’automatisation mobile, vous devez exécuter une instance locale de Appium et disposer des outils nécessaires pour automatiser les appareils iOS.

Vous pouvez automatiser deux types d’appareils iOS locaux :

• Physique : un appareil iOS physique que vous pouvez connecter à votre machine locale via un câble USB.
• Émulateur : un émulateur pour un appareil iOS stocké localement.

Commandes Appium les plus utilisées

La liste ci-dessous décrit les commandes les plus utilisées pour configurer Appium dans le contexte de l'automatisation des appareils mobiles (recommandé pour Appium 2.0) :

• xcrun simctl list : répertorie les appareils, les types d'appareils, les runtimes ou les paires d'appareils disponibles.
• xcrun simctl list devices : répertorie les appareils disponibles.
• xcrun simctl list devicetypes : répertorie les types d'appareils.
• xcrun simctl list runtimes : répertorie les runtimes.
• xcrun simctl list runtimes - répertorie les paires d'appareils.

Stockage d'applications

Vous devrez stocker vos applications mobiles sur la même machine sur laquelle votre serveur Appium est en cours d'exécution, ou télécharger le fichier IPA vers une URL accessible de manière anonyme par le serveur Appium (par exemple, stockage d'objets blob).

L'installation d'applications à partir du Play Store ou de l'App Store n'est pas possible, sauf si vous automatisez manuellement ces applications pour installer votre application spécifique.

Important :

Si votre artefact d'application utilise l'extension APP et que vous souhaitez télécharger l'application vers une URL publique, vous devrez créer un dossier nommé Payload, y placer l'APP, archiver le dossier Payload et changer l'extension en IPA au lieu de ZIP.

De plus, assurez-vous que l'application que vous essayez d'automatiser est compilée pour l'architecture cible (simulateur ou appareil physique).

Configurer un appareil physique iOS

Prérequis

1. Installez Xcode.
2. Ouvrez un terminal et exécutez la commande suivante pour installer Homebrew :

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

3. Exécutez la commande suivante pour installer NodeJS :

   brew install node

4. Installez Appium :
   • Pour Appium 1.0, exécutez la commande suivante : npm install -g appium . Cela a automatiquement installé tous les pilotes nécessaires.
   • Pour Appium 2.0, exécutez la commande suivante : npm install -g appium@next .

Appium 2.0 est livré sans les pilotes installés. Par conséquent, pour installer les pilotes nécessaires, exécutez également la commande suivante : appium driver install xcuitest .

Important :

• Nous vous recommandons d'utiliser Appium 2.0 avec Mobile Automation version 22.10 ou supérieure.

• Installez Appium 2.0 si vous souhaitez tester vos automatisations mobiles sur un appareil physique iOS.

  1. Ouvrez Xcode et autorisez-le à installer tous les composants supplémentaires dont il pourrait avoir besoin. Fermez-le une fois que vous voyez l'écran de présentation.
  2. Démarrez le serveur Appium à l'aide de la commande suivante : appium --port 8001 --default-capabilities "{\"appium:systemPort\":9001}" --relaxed-security .
     
     

     

     
     

Configurer un appareil physique iOS

1. Connectez votre appareil physique à votre Mac.
2. Déverrouillez votre appareil et, si une alerte apparaît, assurez-vous d'autoriser l'ordinateur à y accéder.
3. Obtenez l’URL Appium et enregistrez-la pour plus tard :
   • Accédez à Paramètres système, puis à l'onglet Réseau (Network), et sélectionnez le réseau Wi-Fi auquel l'appareil physique est connecté.
   • Copiez l' adresse IP du réseau Wi-Fi auquel l'appareil est connecté. Le format de l'URL Appium est http://<ipaddress>:8001 ( 8001 est le numéro de port où vous démarrez Appium).
     
     

     

     
     
4. Obtenez l'UDID de l'appareil iOS physique que vous avez connecté à votre machine, à partir de XCode.
   • Accédez à Fenêtre > Périphériques et simulateurs > Périphériques.
   • Cliquez sur l'appareil iOS auquel vous vous êtes connecté.
   • Copiez l' identificateur. Il s'agit de l'UDID, que vous ajouterez ultérieurement en tant que capacité supplémentaire souhaitée, lors de l'ajout de cet appareil physique iOS à MDM.
5. Créez WebDriverAgent avec XCode sur votre Mac.
   • Accédez au dossier appium-webdriveragent en utilisant le chemin suivant : /Users/<username>/appium2/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent et ouvrez le fichier xcodeproj .
   • Sélectionnez WebDriverAgentet ouvrez WebDriverAgentRunnerdans la section Cibles .
   • Basculez vers l'onglet Signature et capacités , sélectionnez Gérer automatiquement la signatureet choisissez un compte d'utilisateur dans la liste déroulante Équipe .
   • Remplacez l’ identifiant de bundle par une valeur unique.

   • Copiez et enregistrez cet identifiant de bundle. Vous l'utiliserez pour ajouter votre application dans MDM (Bundle Id).

     
     

     

     
     
6. Installez WebDriverAgent sur votre appareil physique iOS.
   • Sélectionnez WebDriverAgentRunner dans la barre de navigation de WebDriverAgent.
   • Dans XCode, accédez à Produit, puis cliquez sur Tester. Sur votre appareil physique iOS connecté, vous verrez l'installation de WebDriverAgent .
7. Ajoutez l'appareil émulé local configuré dans le Gestionnaire d'appareils mobiles, à l'aide de la procédure Ajout d'un appareil iOS local dans le Gestionnaire d'appareils mobiles.

Ajouter un appareil iOS local dans le gestionnaire d'appareils mobiles

1. Ouvrez le gestionnaire d'appareils mobiles depuis Studio.
2. Dans le panneau de navigation de gauche, accédez à Appareils (Devices).
3. Configurez votre appareil comme suit :
   • Nom (Name) : saisissez un nom pour identifier votre appareil dans l'onglet Appareils (Devices).
   • URL Appium : saisissez l'URL Appium que vous avez précédemment copiée en utilisant le format suivant : http://<ipaddress>:8001 .
   • Plate-forme (Platform) : cliquez sur le champ pour sélectionner iOS dans la liste déroulante.
   • Nom de l'appareil (Device Name) : saisissez le nom de l'appareil.

   • Capacités souhaitées supplémentaires : ajoutez les capacités suivantes :

     Nom	Valeur (Value)
     automationName	xcuitest (Cette capacité active le pilote Appium iOS)
     udid	the Identifier of the connected physical iOS device

4. (Facultatif) Configurez les détails de journalisation et d'enregistrement vidéo dans l'onglet Journalisation (Logging).
5. (Facultatif) Configurez votre processus de développement dans l'onglet Développement (Development).
   • Fermer les onglets similaires (Close Similar Tabs) (activé par défaut) : fermez les onglets exécutant des connexions avec des appareils et des applications similaires.
   • Attendre la mise à jour de la page (Wait for Page Update) (activé par défaut) : attendez que la source de la page récupère une capture d'écran de chaque action.
6. Cliquez sur Enregistrer et fermer (Save & Close) pour ajouter votre appareil.

   Votre appareil est ajouté à la liste des appareils. Pour ajouter un périphérique local, voir .

   Si vous ne parvenez pas à démarrer votre appareil, consultez Résolution des problèmes : l'appareil physique ne démarre pas.

   
   

   

   
   

Automatisation hybride et Web sur iOS

L'automatisation hybride fonctionne par défaut pour les appareils iOS, à condition que vous n'essayiez pas d'automatiser une application conçue pour la production. Lors de l'automatisation des applications de production, le contenu hébergé par WKWebView ne sera pas automatisable, bien que tout contenu Web hébergé via SFSafariViewController puisse également être automatisé dans les applications de production. Pour plus d'informations, consultez SFSafariViewController.