« 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 installé les pilotes Appium axe DevTools Mobile, vous pouvez configurer vos tests pour vérifier les problèmes d'accessibilité.

Tests automatisés

Démarrez le serveur Appium normalement :

appium

Configurez vos tests

À partir de vos scripts d’automatisation Appium, ajoutez les capacités requises pour axe DevTools Mobile pour la plateforme testée :

Capacité Android requise :

Nom	Type	Description
automationName	`String`	Définissez sur « 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 testée. 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`	Réglez sur « AxeXCUITest » pour utiliser le pilote avec axe DevTools Mobile intégré pour exécuter des analyses d'accessibilité.
bundleId	`String`	L'identifiant du bundle de l'application testée. Notez que `bundleId` fait partie du pilote XCUITest ; vous l'avez peut-être déjà défini.

Initialiser 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 Axe DevTools Mobile sur axe.deque.com. Pour publier des résultats sur axe Developer Hub, vous aurez également besoin d'un ID de projet. Appelez l’API Execute Script, en fournissant axeStartSession ainsi que la clé API et l’ID du projet pour initier la session de test.

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

Si vous souhaitez uniquement enregistrer les résultats localement, il n'est pas nécessaire d'inclure l'identifiant du projet.

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

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

L'automatisation hors ligne est disponible pour les pilotes Appium, mais elle nécessitera une clé de licence hors ligne à des fins d'authentification. Veuillez contacter votre représentant Deque ou le support afin de coordonner la livraison de votre clé de licence. Utilisez ensuite l'extrait de code ci-dessous pour vous connecter au pilote Appium. En savoir plus sur l’utilisation de nos pilotes Appium hors ligne pour effectuer des analyses d’accessibilité sans effectuer de requêtes réseau dans la section Foire aux questions.

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

Quelle est la prochaine étape ?

Une fois que vos tests Appium sont configurés, vous êtes prêt à scanner votre application mobile. Optionnellement, vous pouvez personnaliser votre configuration avant d'analyser, en utilisant nos API pour nommer vos analyses, ignorer certains résultats, étiqueter les analyses et bien plus encore.