Appareils iOS locaux

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

Architecture

Lorsque vous travaillez avec des appareils physiques iOS, vous avez besoin de l'infrastructure suivante :

1. Appareil WindowsOS
   • UiPath Studio (Matériel/Software) : guide d'installation
2. Appareil macOS
   • Serveur Appium
     • Boutique d’accueil
     • Nœud JS
   • Xcode
     • Requis pour installer le pilote Appium sur l’appareil iOS
3. Appareil iOS
   • Webdriver Appium

Figure 1. Architecture pour les appareils physiques locaux iOS

Prérequis

1. macOS 13+ (Venture ou version ultérieure)
2. ID Apple (pour Xcode et l'enregistrement)
3. Appareil iOS physique ( iPhone/iPadt)
4. UiPath Studio 2023.10 (ou version ultérieure)
5. USB pour connecter l'appareil

Configurer un appareil physique iOS

1. Installez Homeêtre.
   1. Ouvrir le terminal (sélectionnez Command+Space).
   2. Exécutez la commande suivante :

      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 

      Figure 2. Installation de la Processus d’accueil - ligne de commande
      

      

      
      
   3. Si vous y êtes invité, exécutez la commande suivante pour ajouter Homebrew à votre variable d'environnement PATH :

      echo >> /Users/<username>/.zprofile
        echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/<username>/.zprofile
        eval "$(/opt/homebrew/bin/brew shellenv)"

   4. Vérifier

      brew -version

2. Installez les outils Xcode et de ligne de commande.
   • Installez Xcode via App Store et ouvrez-le une fois.
   • Depuis le terminal, exécutez ce qui suit :

   • 1. xcode-select –install

     2. sudo xcodebuild -license accept

     3. Vérifier :

        xcodebuild -version

3. Activez le mode développeur sur l’appareil iOS.
   1. Sur votre iPhone ou iPad, accédez à Paramètres > Confidentialité et sécurité > Mode développement.
      Figure 3. Mode développeur sur un appareil iOS
      

      

      
      
   2. Activez et redémarrez.
   3. Après le redémarrage, approuvez la fenêtre contextuelle.
   4. Connectez-vous via USB et faites confiance à l'ordinateur.
      Graphique 4. Activer l’approbation de l’appareil iOS
      

      

      
      
4. Installez Node.js.
   1. Exécutez la commande suivante :

      brew install node

      Figure 5. Installation de Node.js
      

      

      
      
   2. Vérifier

      node -v

      npm -v

5. Installez Appium v3.
   1. Exécutez la commande suivante :

      npm install -g appium@3

      Figure 6. Installation d'Appium.
      

      

      
      
   2. Vérifier

      appium -v

      Image 7. Vérification d’Appium.
      

      

      
      
6. Installez les pilotes et les plug-ins Appium.
   1. Installer le pilote iOS.

      appium driver install xcuitest

      Image 8. Appium x rapportest
      

      

      
      
   2. (Facultatif) Option Configurer Android.

      appium driver install uiautomator2

   3. Lister des pilotes.

      appium driver list

      Image 9. Pilotes Appium
      

      

      
      
7. Configurez WebDriverAgent.
   1. Installez un panier.
   2. Configurez WebDriverAgent.
      1. Accédez au dossier appium-webdriveragent à l'aide du chemin suivant : /Users/<username>/appium2/node_modules/appium-xcuitest-driver/node_modules/appium-webdriver, puis ouvrez le fichier xcodeproj .
         Image 10. Dossier WebDriverAgent
         

         

         
         
      2. Sélectionnez WebDriverAgent et, sous la section Cibles , ouvrez WebDriverAgentRunner.
         Image 11. Exécuteur WebDriverAgent
         

         

         
         
      3. 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 .
      4. Remplacez l’ identifiant de bundle par une valeur unique.
         Image 12. Identifiant du bundle WebDriverAgent
         

         

         
         
      5. Copiez et enregistrez cet identifiant de bundle, que vous utiliserez pour ajouter votre application dans le gestionnaire d'appareils mobiles.
      Problème : un problème courant que vous pouvez rencontrer est un certificat de développeur non approuvé. Pour résoudre le problème, suivez les instructions de la fenêtre contextuelle.

      Image 13. Résolution des problèmes de WebDriverAgent
      

      

      
      
8. Vérifiez l'accès de l'appareil physique.
   1. Confirmez que IntegrationApp est installé sur votre appareil physique.
      Image 14. IntegrationApp sur l'appareil physique
      

      

      
      
   2. Exécutez xcrun xctrace list devices.
   3. Assurez-vous que votre iPhone s'affiche dans la liste. Dans le cas contraire, vérifiez les paramètres de mode développeur et d’approbation . Vous aurez besoin du UDID ou des informations entre parenthèses après le nom de votre appareil.
      Image 15. Accès aux appareils physiques
      

      

      
      
9. Démarrez le serveur Appium.
   1. Ouvrez le terminal et saisissez appium.
      Image 16. Démarrer le serveur Appium
      

      

      
      
   2. Copiez l' URL de l'application.
      Remarque : n'utilisez pas l'emplacement 127.
10. Connectez UiPath à Appium.
    1. Ouvrez UiPath Studio et installez les Activités d'automatisation sur mobile.
    2. Ouvrez le gestionnaire d'appareils mobiles et sélectionnez Ajouter un appareil.
       
       
       
       
       
       
       
       

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.