Migreren naar Axe DevTools voor Web v4.x voor Java
Stappen voor migratie naar versie 4.x van Axe DevTools voor Web voor Java
Axe DevTools voor Web Maven v4.x is een grote herziening van het hele project. De meest opvallende wijzigingen worden hieronder samengevat, gevolgd door meer specifieke wijzigingen aan relevante pakketten.
Samenvatting
De axe-devtools-* reeks van java-pakketten betrof het herstructureren van het productaanbod zowel vanuit een rebrandingperspectief als om de aangeboden integratietools te vereenvoudigen zodat ze specifieker zijn voor de ontwikkelaarservaring.
Met dit in gedachten, vergeleken met eerdere versies waar slechts één pakket werd geleverd, wordt in deze versie een verzameling pakketten geleverd waarmee de eindgebruiker kan kiezen wat essentieel is en het beste past bij de huidige workflow van de eindgebruiker.
Let op brekende wijzigingen. Gezien de splitsing van een monolithische pakkettenstructuur naar een individuele modulaire structuur en de rebranding van de API, vereist de migratie naar v4.0 het stap voor stap volgen van deze migratiehandleiding.
Omgevingsinstellingen
Er zijn geen wijzigingen in de standaard omgevingsvereisten. De gewenste vereisten zijn als volgt:
Installeren van Axe DevTools pakketten
Zorg ervoor dat je toegang hebt tot Axe DevTools via een van de beschikbare opties:
Na succesvolle toegangsinrichting kan men een van de onderstaande pakketten installeren door ze op te nemen in het pom.xml bestand.
Voorbeeld van het selenium pakket dat wordt geïnstalleerd vanuit Deque's Agora:
<dependency>
<groupId>com.deque.html.axe-devtools</groupId>
<artifactId>selenium</artifactId>
<version>4.x.x</version>
</dependency>De beschikbare pakketten zijn:
Raadpleeg elk van de bovenstaande pakketten voor gebruiksinstructies en gedetailleerde API-documentatie.
Opmerkelijke Wijzigingen
Naast installatie- en gebruikswijzigingen met de beschreven pakketten, zijn enkele opmerkelijke wijzigingen onder andere:
- java-pakketnaamsruimte is gewijzigd van
com.deque.attestnaarcom.deque.html.axedevtools. - De
Attestklasse is hernoemd naarAxeSelenium. - De omgevingsvariabele voor het configureren van aangepaste regels is gewijzigd van
ATTEST_PATHnaarAXE_RULESET_PATH. - Het standaardregelsysteem is veranderd. Axe DevTools controleert een gegeven pagina met
wcag2als het standaardregelsysteem. Er is geen aanpassing vereist door de eindgebruiker. Als men een ander regelsysteem wil configureren, kan men de respectieve clausules gebruiken die worden aangeboden in Cucumber/ RSpec. Merk op dat de standaard opnieuw is gewijzigd sinds deze release: vanaf Axe DevTools voor Web 4.5 (december 2022) is het standaardregelsysteem in alle pakketten gestandaardiseerd naar WCAG 2.1 Level AA met beste praktijken uitgeschakeld. Zie Aanpassen van regels.
