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 suivantes décrivent certains problèmes rencontrés avec les appareils Android, ainsi que les solutions correspondantes.

Échec de la connexion en raison de l’exception InvalidArgumentException pour les capacités

Description: la connexion entre un appareil local et une application peut échouer en raison d’une exception InvalidArgumentException causée par une différence dans le format attendu d’une capacité. Le problème se pose lorsqu’une capacité est saisie sous la forme d’une chaîne, alors qu’Appium attend une valeur booléenne. Un message d’erreur indicatif inclura les éléments suivants :

Failed to create session. 
A new session could not be created. 
Details: io.appium.uiautomator2.common.exceptions.InvalidArgumentException: 
Invalid '' setting value type. 
Got java.lang.String. Expected: java.lang.Boolean

Solution : désinstallez les applications suivantes de l’appareil local :

• io.appium.uiautomator2.server
• io.appium.uiautomator2.server.test

Échec de l’activité en raison d’une exception WebDriverException

Description : l’exécution d’un workflow d’automatisation mobile qui automatise un appareil Android peut entraîner une exception WebDriverException. Cette erreur s’affiche généralement sous la forme suivante : Parameters were incorrect. We wanted {\"required\":[\"text\"]} and you sent [\"value\"]", "FaultCode":"WebDriverException"}.

Solution : désinstallez votre version actuelle de UiAutomator 2. Installez ensuite une version plus récente, en utilisant les commandes suivantes dans l’ordre indiqué :

1. appium driver uninstall uiautomator2
2. appium driver install uiautomator2@2.29.0, où les chiffres 2.29.0 désignent la version que vous souhaitez installer. Vous pouvez remplacer cet indicateur par n’importe quelle version disponible.

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 ERR! network This is a problem related to network connectivity.
npm ERR! network In most cases you are behind a proxy or have bad network settings.
npm ERR! network npm ERR! network If you are behind a proxy, please make sure that the npm ERR! network 'proxy' config is set properly. 
See: 'npm help config'

Solution : configurez npm (le gestionnaire des packages des nœuds) pour utiliser votre proxy. Suivez les étapes ci-dessous :

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

     
     

     

     
     

2. 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.
3. 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é. Consultez la page Débogage à distance des WebViews pour plus d’informations sur l’accès aux contextes Web.

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 native, 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 :

1. Utilisez la commande adb devices pour vérifier les appareils existants.
2. Révoquer le débogage sur le téléphone.
3. Redémarrez le serveur ADB, en utilisant les commandes suivantes, dans cet ordre : adb kill-server , puis adb start-server .
4. 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 spécifiée, ce qui provoque 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 : [e-mail]), 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.

Dysfonctionnements d’iOS 12.4.5

Description: iOS 12.4.5 ne fonctionne pas comme prévu lorsqu'il est associé à Appium 1.22.3.

Cause: cela est dû à un problème avec Appium.

Solution: choisissez l'une des options ci-dessous :

• Utilisez une version antérieure d'Appium, telle que 1.17.0.

Important : cela peut entraîner des problèmes avec la dernière version de XCode et peut ne pas fonctionner comme prévu sur macOS Monterey.

• Mettez à niveau l'appareil vers des versions égales ou supérieures à iOS 14.