Migrazione ad axe DevTools per Web v4.x per Java
Passaggi per la migrazione alla versione 4.x di axe DevTools per Web per Java
Axe DevTools per Web Maven v4.x è una riscrittura radicale dell'intero progetto. Di seguito sono riepilogate le modifiche più importanti, seguite da modifiche più specifiche ai pacchetti rilevanti.
Riepilogo
La suite di pacchetti Java axe-devtools-*
ha comportato la riprogettazione dell'offerta del prodotto sia dal punto di vista del rebranding sia per snellire gli strumenti di integrazione forniti, rendendoli più specifici per l'esperienza degli sviluppatori.
Tenendo presente ciò, rispetto alle versioni precedenti in cui veniva fornito un solo pacchetto, in questa versione viene fornita una raccolta di pacchetti che consente all'utente finale di scegliere ciò che è essenziale e che si integra meglio con il flusso di lavoro attuale dell'utente finale.
Attenzione alle modifiche che interrompono la compatibilità. Considerata la separazione da una struttura monolitica di pacchetti a una struttura modulare individuale e il rebranding dell'API, per migrare alla versione 4.0 è necessario seguire passo dopo passo questa guida alla migrazione.
Configurazione dell'ambiente
Non ci sono cambiamenti ai requisiti ambientali predefiniti. I requisiti desiderati sono i seguenti:
Installazione dei pacchetti axe DevTools
Assicurati di avere accesso ad axe DevTools tramite una delle opzioni disponibili:
- Installazione da un bundle
- Installazione dal repository degli artefatti
- Installazione da Agora di Deque
Dopo un setup di accesso riuscito, è possibile installare uno qualsiasi dei pacchetti sottostanti, includendoli nel file pom.xml
.
Esempio per l'installazione del selenium
pacchetto da Agora di Deque:
<dependency>
<groupId>com.deque.html.axe-devtools</groupId>
<artifactId>selenium</artifactId>
<version>4.x.x</version>
</dependency>
I pacchetti disponibili sono:
Per le istruzioni d'uso e la documentazione API dettagliata, fare riferimento a ciascuno dei pacchetti sopra indicati.
Cambiamenti degni di nota
Oltre alle modifiche apportate all'installazione e all'utilizzo dei pacchetti descritti, ecco alcune modifiche degne di nota:
- lo spazio dei nomi del pacchetto Java è stato modificato da
com.deque.attest
acom.deque.html.axedevtools
. - La classe
Attest
è stata rinominata inAxeSelenium
. - La variabile ambiente per la configurazione delle regole personalizzate è stata modificata da
ATTEST_PATH
aAXE_RULESET_PATH
. - Il set di regole predefinito è cambiato. Axe DevTools esegue l'audit di una determinata pagina con
wcag2.1
come set di regole predefinito. Non è richiesta alcuna modifica da parte dell'utente finale. Se si desidera configurare un set di regole diverso, è possibile utilizzare le rispettive clausole offerte in Cucumber/RSpec.