Appareils locaux

Vue d'ensemble (Overview)

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

Rubriques de la section :

• Stockage d'applications
• Configuration d'un appareil Android
• Configurer un appareil Android

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 APK ou 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.

Configuration d'un appareil Android

Pour configurer un appareil Android local, vous devez préparer votre environnement et l'ajouter au gestionnaire d'appareils mobiles.

Rubriques de la section :

• Préparation de l'environnement Android
• Démarrer le serveur Appium
• Créer un émulateur Android
• Activer l'automatisation Web et hybride avec WebDriver
• Configurer un appareil physique Android
• Ajouter un appareil Android local dans le gestionnaire d'appareils mobiles

Préparation de l'environnement Android

Préparez et configurez votre environnement.

1. Téléchargez et installez Node.js.
2. Ouvrez l'invite de commande Node.js et exécutez la commande suivante pour installer Appium :

   npm install -g appium

   Pour plus d'informations sur la configuration d'Appium, consultez Premiers pas avec Appium.

3. Sous Windows, accédez à Paramètres système avancés (Advanced system settings) > Avancé (Advanced) > Variables d'environnement (Environment Variables).
4. Sous Variables système (System variables), cliquez sur Nouveau (New) et configurez les variables suivantes :

   a. Variable ANDROID_HOME.

Nom de la variable: ANDROID_HOME Valeur de la variable: C:\Users\Username\AppData\Local\Android\Sdk Remarque: la partie Username , à l'intérieur du chemin de la valeur de la variable ( Variable Value ), doit être remplacée par le nom réel de l'utilisateur travaillant sur la machine.

b. Variable JAVA_HOME. Java doit déjà être installé pour configurer cette variable. Vous pouvez télécharger Java via un fichier zip ici.

Nom de la variable: JAVA_HOME .

Valeur de la variable: le chemin où se trouve le JDK sur votre machine. Par exemple : C:\Program Files\Java\jdk8 .

Important : si Java est mis à jour automatiquement, vous devez configurer manuellement cette variable avec le chemin mis à jour.

c. Cliquez sur OK pour confirmer.

1. Modifiez la variable Chemin (Path) pour votre utilisateur afin d'inclure Android Debug Bridge (ADB) :

   a. Cliquez sur Nouveau (New) et ajoutez la valeur suivante :

   %ANDROID_HOME%\platform-tools

   b. Cliquez sur OK pour confirmer.

2. Cliquez sur OK pour définir la variable.

   
   

   

   
   

Démarrer le serveur Appium

Avant de démarrer une application sur votre appareil, vous devez commencer à exécuter un serveur Appium sur votre machine. Ouvrez l'invite de commande et exécutez Appium avec les paramètres suivants :

appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload

Remarque :

• Si le téléchargement automatique échoue, vous pouvez pointer vers un chromedriver.exe déjà téléchargé en concaténant la commande suivante :

--chromedriver-executable "path_to_chromedriver"

• Pour obtenir de l'aide sur votre débogage Appium, exécutez la commande suivante :

appium-doctor

• Pour arrêter Appium, utilisez la commande ctrl + c .

Créer un émulateur Android

Créez vos émulateurs Android à l'aide d'Android Studio.

1. Téléchargez et installez Android Studio.
2. Ouvrez Android Studio.
3. Cliquez sur Configurer (Configure) et sélectionnez SDK Manager dans la liste déroulante.
4. Décochez la case Masquer les packages obsolètes (Hide Obsolete Packages) et assurez-vous que Outils SDK Android (Android SDK Tools) (obsolète) est sélectionné.
   
   

   

   
   
5. Cliquez sur Appliquer (Apply) puis sur OK pour fermer.
6. Accédez à Configurer (Configurer) > Gestionnaire AVD (AVD Manager) pour configurer un appareil virtuel. Pour plus d'informations, consultez Créer et gérer des appareils virtuels.
   
   

   

   
   
7. Mettez à jour les applications Google de votre appareil.

Activer l'automatisation Web et hybride avec WebDriver

Activer le débogage WebView.

Si Appium ne détecte pas automatiquement la version Chrome ou WebView sur votre Android, choisissez l'une des options ci-dessous :

1. Utilisez la commande --allow-insecure chromedriver_autodownload . Cela permet à Appium de détecter et de télécharger automatiquement la version de ChromeDriver qui correspond à votre environnement.
2. Spécifiez et téléchargez manuellement WebDriver pour Chrome :

   2.1. Ouvrez votre appareil dans Android Studio.

   2.2. Accédez à Paramètres (Settings) > Applications et notifications (Apps & notifications).

   2.3 Cliquez sur Voir toutes les applications (See all apps).

   2.4. Cliquez sur l'ellipse verticale et sélectionnez Afficher le système (Show system) dans la liste déroulante.

   2.5. Utilisez la fonction de recherche pour rechercher Android System WebView.

   2.6. Ouvrez l'application et accédez à Avancé (Advanced).

   2.7. Copiez le numéro de version au bas de l'écran.

   2.8. Téléchargez WebDriver pour Chrome et tenez compte des points suivants :

   • Sélectionnez la version qui correspond à la version Android System Webview de l'étape précédente et extrayez-la dans un dossier.
   • Vous recherchez une correspondance exacte pour la version (major.minor.patch.revision).
   • Si aucune correspondance n'est disponible, utilisez la dernière version majeure de ChromeDriver qui correspond à la version majeure d'Android System Webview.
   • Si vous souhaitez automatiser l'application Chrome, effectuez simplement les mêmes étapes ci-dessus et notez plutôt la version de Chrome.

Configurer un appareil physique Android

1. Téléchargez et installez Android Studio.
2. Ouvrez Android Studio.
3. Cliquez sur Configurer (Configure) et sélectionnez SDK Manager dans la liste déroulante.
4. Décochez la case Masquer les packages obsolètes (Hide Obsolete Packages) et assurez-vous que Outils SDK Android (Android SDK Tools) (obsolète) est sélectionné.
5. Cliquez sur Appliquer (Apply) puis sur OK pour fermer.
6. Ouvrez une ligne de commande et exécutez la commande suivante pour démarrer un serveur de débogage :

   %LOCALAPPDATA%\\Android\\Sdk\\platform-tools\\adb.exe start-server

7. Connectez votre appareil à votre machine à l'aide d'un câble.
8. Activez les options de développement et le débogage USB sur votre appareil. Pour plus d'informations, consultez Configurer les options de développement sur un appareil.
9. Sur votre téléphone, accédez à Paramètres (Settings) > Options de développement (Developer Options).
10. Dans la section Réseaux (Networking), ouvrez la configuration USB par défaut et définissez-la sur Chargement du téléphone uniquement (Charging phone only).
11. Ajoutez votre appareil au gestionnaire d'appareils mobiles.
12. Exécutez la commande suivante pour démarrer un serveur Appium :

    appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload

    Pour des paramètres supplémentaires, consultez Démarrage du serveur Appium (Starting Appium Server).

    Remarque : Assurez-vous de laisser la connexion au serveur Appium fonctionner sans aucune interférence. Par exemple, si vous cliquez dans le terminal, la communication est coupée, ce qui peut entraîner une erreur de communication dans le gestionnaire d'appareils mobiles.

Ajouter un appareil Android 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 (Appium URL) : saisissez l'hôte local. Par exemple : http://localhost:10001/wd/hub.
   • Plate-forme (Platform) : cliquez sur le champ pour sélectionner Android dans la liste déroulante.
   • Nom de l'appareil (Device Name) : saisissez le nom de l'appareil. Sur Android Studio, vous pouvez par exemple accéder à Configurer (Configure) > Gestionnaire AVD (AVD Manager), puis allez à Plus d'actions (More Actions) > Afficher les détails (View Details).
   • Version de la plate-forme (Platform Version) : ajoutez le numéro de version de votre système d'exploitation Android.
   • Capacités supplémentaires souhaitées (Additional Desired Capabilities) (facultatif) : ajoutez des capacités spécifiques pour personnaliser votre session d'automatisation. Pour plus d'informations, consultez Capacités souhaitées d'Appium.
   • Définir l'emplacement géographique (Appium Desired Capabilities) (facultatif) : définissez l'emplacement de votre appareil pour tester les applications qui utilisent les services de localisation pour générer des données de localisation.
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 appareil local, consultez Appareils locaux.

   
   

   

   
   

Configurer un appareil Android

Pour configurer un appareil iOS local, un simulateur ou un appareil physique, et automatiser une application, vous devrez configurer le serveur Appium sur une machine macOS.

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

Rubriques de la section :

• Préparation de l'environnement Android
• Configurer un appareil physique iOS
• Ajouter un appareil iOS local dans le gestionnaire d'appareils mobiles

Préparation de l'environnement Android

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 :

   npm install -g appium

5. 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.
6. Exécutez la commande suivante pour démarrer Appium :

   appium --port 10001

7. Utilisez Spotlight Search (⌘-Espace) pour ouvrir l'utilitaire réseau.
8. Copiez l'adresse IP pour une utilisation ultérieure lorsque vous ajoutez un appareil iOS dans le gestionnaire d'appareils mobiles. Elle sera incluse dans l'URL Appium (par exemple http://<ipaddress>:8001/wd/hub)
   
   

   

   
   

Configurer un appareil physique iOS

Si vous souhaitez utiliser les activités d'automatisation mobile avec un appareil iOS physique, vous aurez besoin d'un compte de développeur Apple.

1. Suivez les étapes 1 à 5 de Préparation de l'environnement macOS
2. Connectez votre appareil physique à votre Mac.
3. Déverrouillez votre appareil et, si une alerte apparaît, assurez-vous d'autoriser l'ordinateur à y accéder.
4. Ouvrez un terminal et exécutez la commande suivante :

   instruments -s devices

5. Copiez l'ID de votre appareil pour une utilisation ultérieure, lorsque vous ajouterez votre appareil dans le gestionnaire d'appareils mobiles. Par exemple, IDappareil (deviceID) sera ajouté en tant que capacité udid :

   Known Devices: Username's iPhone (13.5.1) (<deviceID>)

6. Connectez-vous à votre compte de développeur Apple et accédez à Adhésion (Membership).
7. Copiez votre ID d'équipe pour une utilisation ultérieure, lorsque vous ajouterez votre appareil dans le gestionnaire d'appareils mobiles. Votre ID d'équipe devra être ajouté aux capacités de l'appareil avec le nom xcodeOrgId.
8. Ouvrez Xcode et accédez à Préférences (Preferences) > Comptes (Accounts).
9. Ajoutez votre compte de développeur Apple.

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 (Appium URL) : saisissez l'hôte local. Par exemple : http://<ipaddress>:8001/wd/hub.
   • 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 supplémentaires souhaitées(appareils physiques) : ajoutez udid et xcodeOrgId. Pour plus d'informations, consultez Configuration d'un appareil physique iOS (Configuring iOS Physical Device).
   • Définir l'emplacement géographique (Appium Desired Capabilities) (facultatif) : définissez l'emplacement de votre appareil pour tester les applications qui utilisent les services de localisation pour générer des données de localisation.
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 appareil local, consultez Appareils locaux.

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