« Configuration pour les tests automatisés »

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

« Préparez-vous aux tests d'accessibilité sur iOS et Android avec axe DevTools Mobile dans Appium. »

Not for use with personal data

Après avoir avez installé les pilotes Appium d'Axe DevTools Mobile, vous pouvez configurer vos tests pour vérifier les problèmes d'accessibilité.

Tests automatisés

Démarrez le serveur Appium comme d'habitude :

appium

Configurez vos tests

Depuis vos scripts d'automatisation Appium, ajoutez les capacités requises pour Axe DevTools Mobile pour la plateforme en cours de test :

Capacité Android requise :

Nom	Type	Description
automationName	`String`	Définissez comme 'AxeUiAutomator2' pour utiliser le pilote avec Axe DevTools Mobile intégré pour exécuter des analyses d'accessibilité.
appPackage	`String`	Le package de l'application en cours de test. Notez que `appPackage` fait partie du pilote UiAutomator2 ; vous l'avez peut-être déjà défini.

Capacité iOS requise :

Nom	Type	Description
automationName	`String`	Définissez comme 'AxeXCUITest' pour utiliser le pilote avec Axe DevTools Mobile intégré pour exécuter des analyses d'accessibilité.
bundleId	`String`	L'identifiant de bundle de l'application en cours de test. Notez que `bundleId` fait partie du pilote XCUITest ; vous l'avez peut-être déjà défini.

Initialisez la bibliothèque

Dans la classe de test initialization, connectez-vous au pilote avec l'une des options suivantes :

Démarrez une session de test avec une clé API Deque

Générez une clé API pour Axe DevTools Mobile sur axe.deque.com. Pour publier les résultats sur Axe Developer Hub, vous aurez également besoin d'un ID de Projet. Appelez l'API Execute Script, en passant axeStartSession ainsi que la clé API et l'ID de Projet pour initier la session de test.

    beforeAll(async () => {
        ...
        const axeAuthSettings = {
            apiKey: "<DEQUE_APIKEY>",
            projectId: "<DEQUE_PROJECT_ID>"
        };
        await driver.execute('mobile: axeStartSession', axeAuthSettings);
        ...
    })

Remarque : Bien que vous puissiez toujours enregistrer les résultats localement, l'omission de projectId déclenchera un avertissement de dépréciation. Nous recommandons fortement d'inclure cette valeur avec axeStartSession.

Démarrez une session de test avec une clé de licence hors ligne

L'automatisation hors ligne est disponible pour les pilotes Appium, mais nécessitera une clé de licence hors ligne pour l'authentification. Veuillez contacter votre représentant Deque ou contacter le support pour coordonner la livraison de votre clé de licence. Ensuite, utilisez le code ci-dessous pour vous connecter au pilote Appium. Apprenez-en davantage sur l'utilisation de nos pilotes Appium hors ligne pour exécuter des analyses d'accessibilité sans effectuer de requêtes réseau dans Foire aux questions.

    beforeAll(async () => {
        ...
        await driver.execute('mobile: axeStartSession', { licenseKey: "<DEQUE_OFFLINE_LICENSE_KEY>" });
        ...
    }

Que faire ensuite ?

Maintenant que vos tests Appium sont configurés, vous êtes prêt à analyser votre application mobile. Facultativement, vous pouvez personnaliser votre configuration avant de scanner, en utilisant nos API pour nommer vos scans, ignorer certains résultats, taguer des scans et plus.