Configuration pour les tests automatisés

Lorsque vous souhaitez avoir un contrôle total sur le moment et le lieu où les analyses d'accessibilité sont exécutées dans vos tests, vous devez mettre en œuvre des tests ciblés. Suivez les étapes ci-dessous pour configurer la bibliothèque AxeDevTools dans vos tests UI afin de vérifier les problèmes d'accessibilité. Vous appellerez explicitement la méthode axe.scan() à des moments précis dans votre code.

Tests automatisés

XCTest est requis pour exécuter axeDevToolsXCUI. D'autres frameworks de test UI 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 au sein de votre classe de test pour conserver l'instance de 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 poster 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 remise de votre clé de licence. Puis utilisez l'extrait ci-dessous pour vous connecter à la bibliothèque axeDevTools. Voir la FAQ pour plus d'informations sur l'utilisation des SDK hors ligne pour des performances optimisées 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 optionnellement personnaliser votre configuration avant de scanner, si vous souhaitez nommer vos analyses, ignorer certains résultats, créer des règles personnalisées, ou taguer les analyses.