Test Suite

2023.4

False

Guide de l'utilisateur de Test Suite

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

Scénarios de résolution des problèmes

Si vous rencontrez des problèmes, envisagez les scénarios de résolution de problèmes suivants :

Automatisation des appareils mobiles

Les rubriques ci-dessous décrivent les problèmes, et leurs solutions correspondantes, pour l'automatisation des appareils mobiles.

Workflow et activités générant des erreurs

Description: le workflow dans Studio génère des erreurs inattendues et les packages d'activités n'affichent pas les versions installées.

Cause: dans votre projet, la version principale du package d'activité UI.Automation ne correspond pas à la version principale du package d'activité Mobile.Automation . Par exemple, la version principale du package UI.Automation installé est 22.10.x, et la version principale du package Mobile.Automation installée est la 22.4.x.

Solution: assurez-vous que les versions principales des packages d'activités UI.Automation et Mobile.Automation , installées dans votre projet, correspondent. Par exemple, associez UI.Automation.Activities version 22.10.x uniquement avec la version 22.10.x de Mobile.Automation.Activities.

Important : utilisez toujours les derniers correctifs disponibles pour les packages d'activités UI.Automation et Mobile.Automation . Par exemple, si UI.Automation ou Mobile.Automation 22.10 est installé, téléchargez les derniers correctifs disponibles pour la version 22.10.

Aucune route trouvée pour wd/hub/session

Condition: lors de l'utilisation d' Appium 2.0.

Description: aucun itinéraire trouvé pour /wd/hub/session .

Solution: ajoutez manuellement le paramètre suivant avant de démarrer la session Appium : --base-path /wd/hub .

Préfixe du fournisseur requis pour toutes les fonctionnalités non standard

Condition: lors de l'utilisation d' Appium 2.0.

Description: toutes les fonctionnalités non standard doivent avoir un préfixe de fournisseur.

Solution: ajoutez manuellement le préfixe appium: pour toutes les capacités, comme suit :

Dans l'invite de commande ou le terminal, au lieu de --default-capabilities "{\"systemPort\": 8201}" , saisissez --default-capabilities "{\"appium:systemPort\": 8201}" .
Dans l'onglet Ajouter un appareil (Add a device) du Gestionnaire d'appareils mobiles (Mobile Device Manager), ajoutez manuellement le préfixe appium: avant le nom de toute fonctionnalité supplémentaire souhaitée.

Le nom de l'automatisation ne peut pas être vide

Condition: lors de l'utilisation d' Appium 2.0.

Description: la capacité automationName ne peut pas être vide.

Solution: ajoutez appium: comme préfixe. Par exemple, appium:automationName .

Impossible de trouver le pilote installé

Condition: lors de l'utilisation d' Appium 2.0.

Description: impossible de trouver le pilote installé pour prendre en charge les majuscules données.

Appium 2.0 n'installe pas automatiquement les pilotes requis. Vous devez les télécharger séparément.

Solution: installez le pilote requis pour votre plate-forme.

Pour les appareils Android, installez le pilote uiautomator2 à l'aide de la commande appium driver install uiautomator2 .
Pour les appareils iOS, installez le pilote xcuitest à l'aide de la commande appium driver install xcuitest.

Android

Les rubriques ci-dessous décrivent les problèmes et les solutions correspondantes pour les appareils iOS.

L'installation d'Appium échoue en raison d'un proxy

Description: l'exécution de la commande npm install -g appium (pour Appium 1.x) ou npm install -g appium@next (pour Appium 2.0) échoue, car vous l'exécutez derrière un proxy. L'erreur génère le message suivant :

npm ERREUR ! network Il s'agit d'un problème lié à la connectivité réseau.

npm ERREUR ! network Dans la plupart des cas, vous êtes derrière un proxy ou avez de mauvais paramètres réseau.

npm ERREUR ! network npm ERR! network Si vous êtes derrière un proxy, assurez-vous que le npm ERR! La configuration du « proxy » du réseau est correctement définie. Voir : 'npm help config'

Remède: configurez npm pour utiliser votre proxy. Suivez les étapes ci-dessous :

Récupérez l'adresse de votre serveur proxy et votre numéro de port :
- Accédez à Options Internet.
- Sélectionnez l'onglet Connexions .
- Sélectionnez Paramètres LAN ( LAN settings) et copiez le contenu dans les champs Address(Adresse) et Port (Port).
Revenez à l'invite de commande Node.js et exécutez une commande qui suit le format ci-dessous :
- Pour les proxys HTTP : npm config set http://your_proxy_address:your_port_number .
- Pour les proxys HTTPS : npm config set https://your_proxy_address:your_port_number.
Exécutez à nouveau la commande npm install -g appium (pour Appium 1.x) ou npm install -g appium@next (pour Appium 2.0).

Impossible d'accéder au contexte Web fourni.

Description: impossible d'accéder au contexte Web fourni. Assurez-vous qu’Android WebView peut être débogué. Pour en savoir plus, rendez-vous sur https://developers.google.com/web/tools/chrome-devtools/remote-debugging/webviews.

Remèdes:

Utilisez WebView en tant que sélecteurs natifs dans les contextes Web non reconnus.
Si les sélecteurs fonctionnent sur les applications Web mais non sur une application, l’application n’activera pas le débogage des WebViews. Dans ce cas, consultez la section Premier pas avec le débogage à distance des WebViews Android et Débogage à distance des WebViews.

Appareil non autorisé

Description: Périphérique non autorisé.

Solution: procédez comme suit :

Utilisez la commande adb devices pour vérifier les périphériques existants.
Révoquer le débogage sur le téléphone.
Redémarrez le serveur ADB, en utilisant les commandes suivantes, dans cet ordre : adb kill-server , puis adb start-server .
Reconnectez l'appareil et confirmez que vous acceptez la connexion sur cet appareil.

Automatisation du navigateur lors du démarrage à partir de l’écran de lancement

Description: l'appareil Android lance une automatisation de navigateur, au lieu de l'application donnée, provoquant ainsi des erreurs.

Solution: commencez plutôt par un navigateur Web.

L'application Android ne démarre pas

Description: l'application Android que vous avez créée ne se lance pas dans le Gestionnaire d'appareils mobiles.

Solution :

Survolez l'application et cliquez sur Modifier ( Edit).
Ajoutez des informations sur l’application dans les champs Package d’ application et Activité de l’application.

iOS

Les rubriques ci-dessous décrivent les problèmes et les solutions correspondantes pour les appareils iOS.

Impossible de cliquer sur les éléments WebView sous iOS 13

Description : lorsque vous cliquez sur un élément WebView, le sélecteur ne fonctionne pas et vous ne pouvez pas automatiser l'élément.

Solution : utilisez des simulateurs avec la dernière version d'iOS et d'Appium 2.

L'appareil physique iOS ne démarre pas

Description: le périphérique physique iOS ne démarre pas.

Solution: procédez comme suit :

Assurez-vous que votre appareil a approuvé le certificat. Sur votre appareil, accédez à Paramètres (Settings) > Général (General) > Profils et gestion des appareils (Profiles & Device Management), appuyez sur l'entrée d'e-mail (par exemple, Développement Apple : nomutilisateur@email.com), puis approuvez le certificat. Si l'appareil utilise votre compte d'entreprise, cela ne sera pas nécessaire.
Si vous obtenez une erreur indiquant que le port 8100 n'est pas accessible, fermez Appium (ctrl + c), puis redémarrez-le.
Si vous obtenez une autre erreur, consultez la page Appium XCUITest Driver Real Device Setup.

L'appareil iOS 16.0 ne démarre pas

Description: l'appareil iOS 16.0 ne démarre pas ou ne se connecte pas.

Solution : installez et utilisez Appium 2.0au lieu d'Appium 1. Consultez la section Prérequis de l'appareil iOS local pour plus d'informations sur l'installation et la gestion d'Appium 2.0.