Migrazione a Axe DevTools for Web v4.x per Ruby

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Passaggi per la migrazione alla versione 4.x di Axe DevTools for Web per Ruby

Not for use with personal data

Axe DevTools for Web Gems v4.x rappresenta una riscrittura importante di tutto il progetto. Le modifiche più significative sono riassunte di seguito, seguite da cambiamenti più specifici ai pacchetti rilevanti.

Riepilogo

La suite di gioielli axe-devtools-* è stata riprogettata per ridurre gli strumenti di integrazione forniti e offrire una migliore esperienza per gli sviluppatori.

Rispetto alle versioni precedenti in cui veniva fornito un unico gemma, questa versione offre una raccolta di gemme che consente agli utenti finali di scegliere ciò che è essenziale e si adatta meglio al loro flusso di lavoro attuale.

Passaggi di Migrazione

Dato il passaggio da una struttura di gemma monolitica a gemme individuali, sono richiesti alcuni passaggi di migrazione. Puoi utilizzare la seguente guida alla migrazione.

Configurazione degli Sviluppatori

Non ci sono modifiche rispetto alla configurazione precedente per gli sviluppatori. I requisiti necessari sono i seguenti:

Ruby (l'ultima versione)
Bundler per le dipendenze delle gemme
Rake come esecutore di compiti
RSpec o Cucumber per il testing
Node e Npm per installare il pacchetto axe-core

Installazione di Axe DevTools for Web Gems

Assicurati di avere accesso a Deque's registry. In caso contrario, refer to the setup guide.

Dopo aver ottenuto l'accesso al registro di Deque, puoi installare qualsiasi delle seguenti gemme includendole nei file Gemfile o gemspec.

gem "axe-devtools-cucumber"

In alternativa, puoi specificare una fonte per la gemma:

gem "attest-devtools-cucumber", :source => 'https://agora.dequecloud.com/artifactory/api/gems/devtools-gems'

Le gemme disponibili sono:

Consultare la documentazione per le istruzioni sull'uso e informazioni dettagliate sulle API.

Disinstallazione delle Integrazioni Ruby

Puoi disinstallare le precedenti integrazioni Ruby eseguendo i comandi seguenti:

gem uninstall axe-matchers
gem uninstall attest-ruby

Modifiche di Rilievo

Altre modifiche di rilievo all'integrazione Ruby includono:

La variabile di ambiente per configurare regole personalizzate è stata cambiata da ATTEST_PATH a AXE_RULESET_PATH. Fare riferimento a advanced usage.
Il set di regole predefinito è cambiato. Axe DevTools for Web analizza una pagina data con wcag2 come set di regole predefinito. Non sono richieste modifiche da parte dell'utente finale. Se desideri configurare un diverso set di regole, puoi utilizzare le relative clausole offerte in la documentazione di Cucumber o la documentazione di RSpec.
I Matchers be_accessible in RSpec sono stati rinominati in be_axe_clean.
La definizione Step be accessible in RSpec è stata rinominata in be axe clean.