Configuration pour les tests automatisés

Lorsque vous souhaitez avoir un contrôle total sur le moment et l'endroit 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 d'interface utilisateur afin de vérifier les problèmes d'accessibilité. Vous appellerez explicitement la méthode axe.scan() à des moments spécifiques dans votre code.

Remarque : Cela suppose que vous avez déjà ajouté la bibliothèque à votre projet. Pour les étapes d'installation du plugin Gradle, veuillez consulter Commencer.

Tests Automatisés

Initialisez la Bibliothèque

Dans la classe de test init, connectez-vous à la bibliothèque avec l'une des options suivantes :

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 du projet depuis Developer Hub.

private val axe = AxeDevTools()

init {
  ...
  axe.startScanSession(apiKey = "<DEQUE_APIKEY>",
            projectId = "<DEVHUB_PROJECT_ID>")
  ...
}

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

private val axe = AxeDevTools()

init {
  ...
  axe.startScanSession(apiKey = "<DEQUE_APIKEY>")
  ...
}

Connecter avec la Clé de Licence Hors Ligne

L'automatisation hors ligne est disponible pour le SDK Android, mais nécessite une clé de licence hors ligne à des fins d'authentification. Veuillez contacter votre représentant Deque ou contacter le support pour coordonner la livraison de votre clé de licence. Utilisez ensuite le 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 des performances optimisées sans requêtes réseau.

val axe = AxeDevTools()

init {
    axe.setOfflineLicenseKey("OFFLINE_LICENSE_KEY")
}

Configurer le Registre d'Instrumentation

C'est la partie qui permet à Axe DevTools pour Android de se connecter à la hiérarchie de vues. Cela peut être configuré avant l'exécution de vos tests dans le bloc @Before fun setup().

private val axe = AxeDevTools()

@Before
fun setup()  {
  axe.setInstrumentation(InstrumentationRegistry.getInstrumentation())
}

Quoi de Neuf ?

Maintenant que vous avez créé un projet et importé la bibliothèque AxeDevTools, vous êtes prêt à analyser votre application mobile. Facultativement, vous pouvez personnaliser votre configuration avant de lancer une analyse, en utilisant nos APIs pour nommer vos analyses, ignorer certains résultats, créer des règles personnalisées, taguer des analyses et plus encore.