Appareils Android locaux

Configuration des appareils Android locaux

Pour configurer un appareil local afin qu'il fonctionne avec les activités Mobile Automation, vous devez exécuter une instance locale d'Appium et disposer des outils nécessaires pour automatiser les appareils Android.

Vous pouvez automatiser deux types d’appareils Android locaux :

• Physical - a physical Android device that you can connect to your local machine, through a USB cable.
• Emulator - an emulator for an Android 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 des appareils mobiles :

• appium driver list - lists installed drivers (recommended for Appium 2.0)
• adb devices - répertorie les appareils connectés
• adb start-server - démarre le débogage du serveur
• adb kill-server - arrête le serveur de débogage
• ctrl + c - tue Appium
• appium-doctor - aide au débogage de votre Appium.

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 périphérique Android physique local

Prérequis

Suivez les étapes ci-dessous pour remplir les conditions préalables à la configuration d'un appareil Android physique local :

1. Téléchargez et installez Java. Vous pouvez télécharger Java via un fichier zip ici.

2. Téléchargez et installez Node.js. Vous pouvez télécharger la dernière version de Node.js ici.

3. After the installation of Node.js is finished, open a command prompt and check if it was successful, using the following commands:

   • node-v - returns the Node.js version installed on your machine. The version returned needs to be equal to, or higher than 19.
   • npm-v - returns the version of npm installed on your machine. The version returned needs to be equal to, or higher than 8.

4. Téléchargez et installez Android Studio. Vous pouvez télécharger Android Studio ici.

5. Install Android SDK Tools (Obsolete) using Android Studio.

6. In Windows, navigate to Advanced system settings > Advanced > Environment Variables.

7. Sous Variables système (System variables), cliquez sur Nouveau (New) et configurez les variables suivantes :

   1. Variable JAVA_HOME . Indique le dossier dans lequel Java a été installé. 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.

   2. Variable ANDROID_HOME . Indique le dossier dans lequel le SDK Android a été installé. Nom de la variable: ANDROID_HOME Valeur de la variable: le chemin où se trouve le SDK Android sur votre machine. Par exemple : C:\Users\Username\AppData\Local\Android\Sdk Remarque: la partie Username , à l'intérieur du chemin d'accès de la variable , doit être remplacée par le nom réel de l'utilisateur agissant sur la machine.

      Important :

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

1. Open the Node.js command prompt and install Appium:
   • For Appium 1.0, run the following command: npm install -g appium. Appium 1.0 comes with all drivers installed.
   • 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 uiautomator2.

Pour plus d’informations sur la configuration de Appium 1.0, consultez l’introduction au démarrage rapide.

Remarque :

We recommend using Appium 2.0 with Mobile Automation version 22.10 or higher.

1. Redémarrez l'ordinateur pour appliquer les modifications.
2. Open the physical mobile device, and enable Developer Options.
   • Sur votre téléphone, accédez à Paramètres (Settings) > Options de développement (Developer Options).
   • 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).
3. Enable USB debugging.
4. Sur votre téléphone, accédez à Paramètres (Settings) > Options de développement (Developer Options).
5. 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).

Configuration d'un périphérique Android physique local

1. Connectez le périphérique physique à la machine locale à l'aide d'un câble USB.

2. Ouvrez une invite de commande et démarrez le serveur de débogage à l'aide de la commande suivante : adb.exe start-server .

3. Allow USB debugging on the mobile device (if you're asked to allow it).

4. Ajoutez manuellement le paramètre the --base-path /wd/hub avant de démarrer la session Appium.

5. Start the Appium server, using the following command: appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload.

   Remarque :

   • If the auto-download fails, you can point to an already downloaded chromedriver.exe, by concatenating the following command:

     --chromedriver-executable "path\_to\_chromedriver"

   • Make sure to leave the Appium server connection running without any interferences. For example, if you click within the terminal, the communication is cut off, which may lead to a communication error in Mobile Device Manager.

6. Ajoutez l'appareil émulé local configuré dans le Gestionnaire d'appareils mobiles, à l'aide de la procédure Ajout d'un appareil Android local dans le Gestionnaire d'appareils mobiles .

Configuration d'un appareil Android émulé local

Prérequis

1. Téléchargez et installez Java. Vous pouvez télécharger Java via un fichier zip ici.

2. Téléchargez et installez Node.js. Vous pouvez télécharger la dernière version de Node.js ici.

3. After the installation of Node.js is finished, open a command prompt and check if it was successful, using the following commands:

   • node-v - returns the Node.js version installed on your machine. The version returned needs to be equal to, or higher than 19.
   • npm-v - returns the version of npm installed on your machine. The version returned needs to be equal to, or higher than 8.

4. Téléchargez et installez Android Studio. Vous pouvez télécharger Android Studio ici.

5. In Windows, navigate to Advanced system settings > Advanced > Environment Variables.

6. Sous Variables système (System variables), cliquez sur Nouveau (New) et configurez les variables suivantes :

   1. Variable JAVA_HOME . Indique le dossier dans lequel Java a été installé. 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.

   2. Variable ANDROID_HOME . Indique le dossier dans lequel le SDK Android a été installé.

      • Nom de la variable : ANDROID_HOME
      • Variable value: the path where the Android SDK is located on your machine. For example: C:\Users\Username\AppData\Local\Android\Sdk
      Remarque :

      La partie Username , à l’intérieur du chemin d’accès Valeur de variable , doit être remplacée par le nom réel de l’utilisateur opérateur sur la machine.

      1. Open the Node.js command prompt and install Appium:

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

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

         Pour plus d’informations sur la configuration de Appium 2.0, consultez l’introduction au démarrage rapide.

         Remarque :

         We recommend using Appium 2.0 with Mobile Automation version 22.10 or higher.

         1. Redémarrez l'ordinateur pour appliquer les modifications.

Créer un émulateur Android

Create your Android emulator using Android Studio.

1. Ouvrez Android Studio.

2. Cliquez sur Configurer (Configure) et sélectionnez SDK Manager dans la liste déroulante.

3. 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é.

   

4. Cliquez sur Appliquer (Apply) puis sur OK pour fermer.

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

   

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

Activer l'automatisation Web et hybride avec WebDriver

Activez le débogage WebView sur l’appareil local afin de permettre au gestionnaire d’appareils mobiles de reconnaître la majorité des éléments d’IU à l’intérieur d’une application.

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 :
   1. Ouvrez votre appareil dans Android Studio.
   2. Accédez à Paramètres > Applications et notifications. 3 Cliquez sur Voir toutes les applications.
   3. Cliquez sur l'ellipse verticale et sélectionnez Afficher le système (Show system) dans la liste déroulante.
   4. Utilisez la fonction de recherche pour rechercher Android System WebView.
   5. Ouvrez l'application et accédez à Avancé (Advanced).
   6. Copiez le numéro de version au bas de l'écran.
   7. 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.
3. Ajoutez l'appareil émulé local configuré dans le Gestionnaire d'appareils mobiles, à l'aide de la procédure Ajout d'un appareil Android local 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.

   • Additional Desired Capabilities (Optional) - Add specific capabilities to customize your automation session.

     Important :

     Pour activer les pilotes Appium précédemment installés, ajoutez la fonctionnalité suivante à la section Capacités supplémentaires souhaitées :

     Nom	Valeur (Value)
     appium:automationName	UiAutomator2

     Pour plus d'informations, consultez Capacités souhaitées d'Appium.

4. (Optional) - Set your device location in the Location tab, to test applications that use Location Services to generate location data.

   

5. (Facultatif) Configurez les détails de journalisation et d'enregistrement vidéo dans l'onglet Journalisation (Logging).

6. (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.

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