Migración a axe DevTools for Web v4.x para Java
Pasos para migrar a la versión 4.x de axe DevTools for Web para Java
Axe DevTools for Web Maven v4.x es una reescritura importante de todo el proyecto. A continuación se resumen los cambios más notables, seguidos de cambios más específicos en los paquetes relevantes.
Resumen
La suite de paquetes Java axe-devtools-*
implicó rediseñar la oferta de productos tanto desde una perspectiva de cambio de marca como también reducir las herramientas de integración proporcionadas para que sean más específicas para la experiencia del desarrollador.
Con esto en mente, en comparación con versiones anteriores donde solo se proporcionaba un único paquete, en esta versión se proporciona una colección de paquetes que permiten al usuario final elegir lo que es esencial y se adapta mejor a su flujo de trabajo actual.
Tenga cuidado con los cambios disruptivos. Dada la división de una estructura de paquete monolítica a una estructura modular individual y el cambio de marca de la API, para migrar a v4.0 es necesario seguir esta guía de migración paso a paso.
Configuración del entorno
No hay cambios con los requisitos del entorno predeterminado. Los requisitos deseados son los siguientes:
Instalación de paquetes de axe DevTools
Asegúrese de tener acceso a axe DevTools a través de una de las opciones disponibles:
- [Instalación desde un conjunto][]
- Instalación desde su repositorio de artefactos
- [Instalación desde el Ágora de Deque][]
Después de configurar exitosamente el acceso, se puede instalar cualquiera de los siguientes paquetes, incluyéndolos en el archivo pom.xml
.
Ejemplo de instalación del selenium
paquete desde Agora de Deque:
<dependency>
<groupId>com.deque.html.axe-devtools</groupId>
<artifactId>selenium</artifactId>
<version>4.x.x</version>
</dependency>
Los paquetes disponibles son:
Consulte cada uno de los paquetes anteriores para obtener instrucciones de uso y documentación detallada de la API.
Cambios notables
Además de los cambios de instalación y uso de los paquetes descritos, algunos cambios dignos de mención incluyen:
- El espacio de nombres del paquete Java cambió de
com.deque.attest
acom.deque.html.axedevtools
. - La clase
Attest
fue renombrada aAxeSelenium
. - La variable de entorno para configurar reglas personalizadas se ha cambiado de
ATTEST_PATH
aAXE_RULESET_PATH
. - El conjunto de reglas predeterminado ha cambiado. Axe DevTools audita una página determinada con
wcag2.1
como conjunto de reglas predeterminado. No se requiere ningún cambio por parte del usuario final. Si uno desea configurar un conjunto de reglas diferente, puede utilizar las cláusulas respectivas ofrecidas en Cucumber/RSpec.