Test Suite

2023.4

False

Guide de l'utilisateur de Test Suite

Dernière mise à jour 28 févr. 2024

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 :

Physique : un appareil Android physique que vous pouvez connecter à votre machine locale via un câble USB.
Émulateur : un émulateur pour un appareil Android 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 :

appium driver list - répertorie les pilotes installés (recommandé pour 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 :

Téléchargez et installez Java. Vous pouvez télécharger Java via un fichier zip ici.
Téléchargez et installez Node.js. Vous pouvez télécharger la dernière version de Node.js ici.
Une fois l'installation de Node.js terminée, ouvrez une invite de commande et vérifiez si elle a réussi à l'aide des commandes suivantes :
- node-v : renvoie la version de Node.js installée sur votre machine. La version renvoyée doit être égale ou supérieure à 19.
- npm-v - renvoie la version de npm installée sur votre machine. La version renvoyée doit être égale ou supérieure à 8.
Téléchargez et installez Android Studio. Vous pouvez télécharger Android Studio ici.
Installez les outils du SDK Android (obsolètes) à l'aide d' Android Studio.
Sous Windows, accédez à Paramètres système avancés (Advanced system settings) > Avancé (Advanced) > Variables d'environnement (Environment Variables).
Sous Variables système (System variables), cliquez sur Nouveau (New) et configurez les variables suivantes :

a. Variable JAVA_HOME . Pointe vers 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 .

b. Variable ANDROID_HOME . Pointe vers 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 de la valeur de la variable ( Variable Value ), doit être remplacée par le nom réel de l'utilisateur travaillant sur la machine.

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

Ouvrez l'invite de commande Node.js et installez Appium:
- Pour Appium 1.0, exécutez la commande suivante : npm install -g appium . Appium 1.0 est livré avec tous les pilotes installés.
- 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
                           uiautomator2

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

Remarque : nous vous recommandons d'utiliser Appium 2.0 avec Mobile Automation version 22.10 ou supérieure.

Redémarrez l'ordinateur pour appliquer les modifications.
Ouvrez l'appareil mobile physique et activez les options du développeur.
- 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).
Activer le débogage USB.
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).

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

Connectez le périphérique physique à la machine locale à l'aide d'un câble USB.
Ouvrez une invite de commande et démarrez le serveur de débogage à l'aide de la commande suivante : adb.exe start-server .
Autoriser le débogage USB sur l'appareil mobile (si vous êtes invité à l'autoriser).
Ajoutez manuellement le paramètre the --base-path /wd/hub avant de démarrer la session Appium.
Démarrez le serveur Appium à l'aide de la commande suivante : 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"
- 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.
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

Téléchargez et installez Java. Vous pouvez télécharger Java via un fichier zip ici.
Téléchargez et installez Node.js. Vous pouvez télécharger la dernière version de Node.js ici.
Une fois l'installation de Node.js terminée, ouvrez une invite de commande et vérifiez si elle a réussi à l'aide des commandes suivantes :
- node-v : renvoie la version de Node.js installée sur votre machine. La version renvoyée doit être égale ou supérieure à 19.
- npm-v - renvoie la version de npm installée sur votre machine. La version renvoyée doit être égale ou supérieure à 8.
Téléchargez et installez Android Studio. Vous pouvez télécharger Android Studio ici.
Sous Windows, accédez à Paramètres système avancés (Advanced system settings) > Avancé (Advanced) > Variables d'environnement (Environment Variables).
Sous Variables système (System variables), cliquez sur Nouveau (New) et configurez les variables suivantes :

a. Variable JAVA_HOME . Pointe vers 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 .

b. Variable ANDROID_HOME . Pointe vers 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 de la valeur de variable ( Variable Value ), doit être remplacée par le nom réel de l'utilisateur travaillant sur la machine.
1. Ouvrez l'invite de commande Node.js et installez Appium:
Pour Appium 1.0, exécutez la commande suivante : npm install -g appium . Appium 1.0 est livré avec tous les pilotes installés.
Pour Appium 2.0, exécutez la commande suivante : npm install -g appium@next .

Appium 2.0-beta 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 uiautomator2.

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

Remarque : nous vous recommandons d'utiliser Appium 2.0 avec Mobile Automation version 22.10 ou supérieure.

Redémarrez l'ordinateur pour appliquer les modifications.

Créer un émulateur Android

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

Ouvrez Android Studio.
Cliquez sur Configurer (Configure) et sélectionnez SDK Manager dans la liste déroulante.
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é.
Cliquez sur Appliquer (Apply) puis sur OK pour fermer.
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.
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 :

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

Ouvrez le gestionnaire d'appareils mobiles depuis Studio.
Dans le panneau de navigation de gauche, accédez à Appareils (Devices).

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.

Important : pour activer les pilotes Appium précédemment installés, ajoutez la capacité 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.

(Facultatif) : définissez l'emplacement de votre appareil dans l'onglet Emplacement (Location) pour tester les applications qui utilisent les services de localisation pour générer des données de localisation.
(Facultatif) Configurez les détails de journalisation et d'enregistrement vidéo dans l'onglet Journalisation (Logging).
(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.
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 .