Migrer le plugin Appium vers 2.0.0

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Guide pour migrer les premiers utilisateurs vers les dernières modifications d'axe DevTools Mobile pour Appium.

Not for use with personal data

Remarque : si vous débutez avec axe DevTools Mobile pour Appium, consultez le guide d'installation.

Merci pour votre retour ! Nous avons apporté quelques modifications à notre plugin Appium pour mieux vous servir et améliorer votre manière actuelle de tester les applications mobiles. Si vous avez implémenté la version 1.0.0 du plugin Appium, suivez ce guide pour connaître les étapes simples à suivre pour passer à la version 2.0.0.

Mise à jour vers la version 2.0.0

Désinstaller axeDevToolsMobile :

appium plugin uninstall axeDevToolsMobile

Une nouvelle installation du plugin récupérera la version la plus récente. Installez le plugin sur votre instance Appium via la ligne de commande :

appium plugin install --source=npm @axe-devtools/appium-plugin

Mise à jour des paramètres

À partir de vos scripts d'automatisation Appium, copiez puis supprimez la "capacité" 'clé' précédemment requise pour la clé API d'axe DevTools Mobile.

La clé API sera déplacée vers un objet de paramètres à transmettre à la méthode d'Appium. executeScript

tip

Vous pouvez envisager d’ajouter une fonction utilitaire à votre script de test comme emplacement central pour lancer une analyse d’accessibilité.

Mise à jour de la méthode pour rechercher les problèmes d'accessibilité

Auparavant, le plugin interceptait la méthode source de la page d'Appium pour vérifier les problèmes d'accessibilité. Cela a été remplacé afin que la source de la page soit toujours disponible pour être utilisée dans les tests comme vous l'avez fait auparavant !

Partout où vous souhaitez lancer un test d'accessibilité, remplacez les instances d'appel de l'API source de la page par API d'exécution de script.

executeScript("axe:scan", Settings)

Paramètre	Type	Description
Paramètres	`Object`	Inclut les configurations requises pour axe DevTools Mobile. (Voir les clés requises dans Settings).
Source de la page	`String`	Facultatif : si vous avez déjà récupéré la page source de l'écran actuel, vous pouvez la fournir à axe DevTools Mobile sans encourir à nouveau ce coût de requête. Remarque : si vous constatez que la capture d'écran et les résultats ne correspondent pas dans le tableau de bord, la page source est peut-être obsolète et ne doit pas être utilisée.

Clés requises dans les paramètres

Touche	Type	Description
Clé API	`String`	Requis par Deque pour fournir l'accès aux utilisateurs autorisés. Accédez à votre clé API axe DevTools Mobile dans le portail axe Compte .

Exemples

Voici un exemple des changements mis en évidence ci-dessus. Des exemples complets sont disponibles dans d’autres langues client.

Exemple en Python

def runAccessibilityScan(self):
    settings = {}
    settings['apiKey'] = "<your-api-key-here>"
    return self.driver.execute_script('axe:scan', settings)

Exemple avec PageSource en Python

def runAccessibilityScan(self):
    settings = {}
    settings['apiKey'] = "<your-api-key-here>"
    pageSource = self.driver.page_source
    return self.driver.execute_script('axe:scan', settings, pageSource)