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 :

• Physical - a physical iOS device that you can connect to your local machine, through a USB cable.
• Emulator - an emulator for an iOS device that's stored locally.

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 pour les appareils mobiles.

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

Avertissement :

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 :

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

   1. 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)"
      

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

brew install node 4. Installez Appium :

• For Appium 1.0, run the following command: npm install -g appium. This automatically installed all drivers needed.
• For Appium 2.0, run the following command: npm install -g appium@next.

Appium 2.0 comes without the drivers installed. Therefore, to install the needed drivers, also run the following command: appium driver install xcuitest.

Avertissement :

• We recommend using Appium 2.0 with Mobile Automation version 22.10 or higher.
• 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 a 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 :

   • Go to System Settings, then the Network tab, and select the Wi-Fi network that the physical device is connected to.
   • 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 du port à partir duquel vous allez démarrer Appium).
     

4. Obtenez l'UDID de l'appareil iOS physique que vous avez connecté à votre machine, à partir de XCode.

   • Go to Window > Devices and Simulators > Devices.
   • Cliquez sur l'appareil iOS auquel vous vous êtes connecté.
   • Copy the Identifier. This is the UDID, that you'll later add as an additional desired capability, when adding this iOS physical device to MDM.

5. Créez WebDriverAgent via 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 .
   • Select WebDriverAgent, and open WebDriverAgentRunner, under the Targets section.
   • Switch to the Signing & Capabilities tab, select Automatically manage signing, and choose a user account from the Team dropdown.
   • Change the Bundle Identifier to a unique value.
   • Copiez et enregistrez cet identificateur de bundle. Vous l'utiliserez pour ajouter votre application dans le gestionnaire d'appareils mobiles.
     

6. Install the WebDriverAgent on your iOS physical device.

   • Select WebDriverAgentRunner in the WebDriverAgent navigation bar.
   • In XCode, go to Product, and click Test. On your connected iOS physical device, you'll see the WebDriverAgent installing.

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).

   • Appium URL - Enter the Appium URL, that you previously copied, using the following format: 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.

   • Additional Desired Capabilities - Add the following capabilities:

     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.