Migration vers axe DevTools for Web v4.x pour Java
Étapes de la migration vers la version 4.x d'axe DevTools for Web pour Java
axe DevTools for Web Maven v4.x est une réécriture majeure de l'ensemble du projet. Les changements les plus notables sont résumés ci-dessous, suivis de modifications plus spécifiques apportées aux packages concernés.
Résumé
La suite de packages Java « axe-devtools-* » a nécessité une refonte de l'offre de produits à la fois dans une perspective de changement de marque et pour réduire les outils d'intégration fournis afin qu'ils soient plus spécifiques à l'expérience du développeur.
Dans cet esprit, par rapport aux versions précédentes où un seul package était fourni, dans cette version, une collection de packages est fournie permettant à l'utilisateur final de choisir ce qui est essentiel et s'adapte le mieux à son flux de travail actuel.
Attention aux changements radicaux. Compte tenu de la scission d'une structure de package monolithique vers une structure modulaire individuelle et du changement de marque de l'API, la migration vers la version 4.0 nécessite de suivre ce guide de migration étape par étape.
Configuration de l'environnement
Il n'y a pas de changements dans les exigences d'environnement par défaut. Les exigences souhaitées sont les suivantes :
- [Java][]
- [Maven][] pour les dépendances
Installation des packages axe DevTools
Assurez-vous d'avoir accès à axe DevTools via l'une des options disponibles :
- [Installation à partir d'un bundle][]
- [Installation à partir de votre référentiel d'artefacts][]
- [Installation depuis l'Agora de Deque][]
Une fois l'installation de l'accès réussie, vous pouvez installer l'un des packages ci-dessous en les incluant dans le fichier pom.xml
.
Exemple pour l'installation du selenium
paquet depuis l'Agora de Deque :
<dependency>
<groupId>com.deque.html.axe-devtools</groupId>
<artifactId>selenium</artifactId>
<version>4.x.x</version>
</dependency>
Les packages disponibles sont :
- [Axe DevTools Selenium][]
- [Axe DevTools Hamcrest][]
- [Axe DevTools Cucumber][]
Veuillez vous référer à chacun des packages ci-dessus pour obtenir des instructions d'utilisation et une documentation API détaillée.
Changements notables
Outre les modifications d'installation et d'utilisation des packages décrits, voici quelques changements notables :
- l'espace de noms du package Java a été modifié de
com.deque.attest
àcom.deque.html.axedevtools
. - La classe
Attest
a été renommée enAxeSelenium
. - La variable d'environnement pour la configuration des règles personnalisées a été modifiée de
ATTEST_PATH
àAXE_RULESET_PATH
. - Les règles par défaut ont changé. Axe DevTools audite une page donnée avec
wcag2.1
comme ensemble de règles par défaut. Aucune modification n’est requise de la part de l’utilisateur final. Si l'on souhaite configurer un ensemble de règles différent, on peut utiliser les clauses respectives proposées dans Cucumber/RSpec.
[axe devtools Cucumber] : java-test-Cucumber [axe devtools hamcrest] : java-test-hamcrest [axe devtools selenium] : java-test-selenium [Java] : https://openjdk.java.net/ [Maven] : https://maven.apache.org/ [Installation à partir d'un bundle] : java-install-bundle [Installation à partir de votre référentiel d'artefacts] : ar-nexus-setup [Installation depuis l'Agora de Deque] : java-install-agora