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

Ajoutez le framework à vos tests d'interface utilisateur

Not for use with personal data

Lorsque vous souhaitez un contrôle total sur le moment et l’endroit où les analyses d'accessibilité s'exécutent dans vos tests, vous devez implémenter des tests ciblés. Suivez les étapes ci-dessous pour configurer la bibliothèque AxeDevTools dans vos tests d'interface utilisateur pour vérifier les problèmes d'accessibilité. Vous appellerez explicitement la méthode axe.scan() à des points spécifiques dans votre code.

Tests automatisés

XCTest est requis pour exécuter axeDevToolsXCUI. D'autres frameworks de tests d'interface utilisateur qui utilisent XCTest sont pris en charge.

Configuration des tests

Dans tout fichier utilisé pour les tests d'accessibilité, importez le framework axeDevToolsXCUI.

import axeDevToolsXCUI

Créez un objet dans votre classe de test pour conserver l'instance d'axe DevTools :

var axe: AxeDevTools?

Initialisez le framework dans les méthodes setUp ou setUpWithError .

Démarrer une session de test

Générez une clé API sur axe.deque.com. Pour publier les résultats sur axe Developer Hub, utilisez startScanSession avec la clé API et l'ID de projet de Developer Hub.

axe = try? AxeDevTools.startScanSession(apiKey: "<DEQUE_APIKEY>",
            projectId: "<DEVHUB_PROJECT_ID>")

Si vous ne souhaitez enregistrer les résultats que localement, vous n'avez pas besoin d'inclure l'ID de projet.

axe = try? AxeDevTools.startScanSession(apiKey: "<DEQUE_APIKEY>")

Exemple de configuration

import axeDevToolsXCUI
import XCTest

class MyUITests: XCTestCase {
    var axe: AxeDevTools?
    var app = XCUIApplication()

    override func setUpWithError() throws {
        axe = try AxeDevTools.startScanSession(apiKey: "<DEQUE_APIKEY>",
            projectId: "<DEVHUB_PROJECT_ID>")
        // Include the projectId to post results to axe Developer Hub (recommended)
        app.launch()
    }
}

Connexion avec la clé de licence hors ligne

L'automatisation hors ligne est disponible pour le SDK iOS, mais nécessitera une clé de licence hors ligne à des fins d'authentification. Veuillez contacter votre représentant Deque ou le support pour coordonner la livraison de votre clé de licence. Ensuite, utilisez l'extrait de code ci-dessous pour vous connecter à la bibliothèque axeDevTools . Consultez la FAQ pour plus d'informations sur l'utilisation des SDK hors ligne pour une performance optimisée sans requêtes réseau.

import axeDevToolsXCUI_noauth
import XCTest

class MyUITests: XCTestCase {

    var axeDevTools: AxeDevTools?

    override func setUpWithError() throws {
        axeDevTools = AxeDevTools.loginWithLicenseKey("DEQUE_LICENSE_KEY")
    ...
}

Et ensuite ?

Maintenant que vous avez créé un projet et intégré le framework axeDevToolsXCUI , vous êtes prêt à analyser votre application mobile. Vous pouvez également, si vous le souhaitez, personnaliser votre configuration avant l'analyse, si vous souhaitez nommer vos analyses, ignorer certains résultats, créer des règles personnalisées ou étiqueter les analyses.