Migrazione ad axe DevTools per Web v4.x per Ruby

Axe DevTools for Web Gems 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 gems axe-devtools-* è stata riprogettata per snellire gli strumenti di integrazione forniti e offrire una migliore esperienza agli sviluppatori.

Rispetto alle versioni precedenti in cui veniva fornita una sola gemma, questa versione fornisce una raccolta di gemme che consente agli utenti finali di scegliere quella essenziale e più adatta al loro flusso di lavoro attuale.

Fasi della migrazione

Data la separazione da una struttura monolitica di gemme a gemme singole, sono necessari alcuni passaggi di migrazione. È possibile utilizzare la seguente guida alla migrazione.

Configurazione dello sviluppatore

Non ci sono cambiamenti rispetto alla precedente configurazione dello sviluppatore. I requisiti necessari sono i seguenti:

• Ruby (l'ultima versione)
• Bundler per le dipendenze gem
• Rake come task runner
• RSpec o Cucumber per i test
• [Node][] e Npm per installare il pacchetto axe-core

Installazione di axe DevTools per Web Gems

Assicurati di avere accesso al [registro di Deque][configurazione del registro npm di attest]. In caso contrario, [fare riferimento alla guida all'installazione][].

Dopo aver avuto accesso all'archivio di Deque, puoi installare una qualsiasi delle seguenti gemme includendole nei file Gemfile o gemspec.

gem "axe-devtools-cucumber"

In alternativa, puoi specificare un repository per la gemma:

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

Le gemme disponibili sono:

• [axe DevTools per Web Cucumber] []
• [axe DevTools per Web RSpec] []
• [axe DevTools per Web Capybara][]
• axe DevTools per Web Selenium
• axe DevTools per Web Watir

Per istruzioni sull'uso e informazioni dettagliate sulle API, fare riferimento alla documentazione.

Disinstallazione delle integrazioni Ruby

È possibile disinstallare le precedenti integrazioni Ruby eseguendo i comandi seguenti:

gem uninstall axe-matchers
gem uninstall attest-ruby

Cambiamenti degni di nota

Altre modifiche degne di nota all'integrazione di Ruby includono:

• La variabile d'ambiente per la configurazione delle regole personalizzate è stata modificata da ATTEST_PATH a AXE_RULESET_PATH. Fare riferimento a uso avanzato.
• Il set di regole predefinito è cambiato. Axe DevTools for Web esegue l'audit di una determinata pagina utilizzando wcag2 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 nella documentazione di Cucumber o nella documentazione RSpec.
• be_accessible Matchers in RSpec è stato rinominato in be_axe_clean.
• La definizione del passaggio in RSpec be accessible è stata rinominata in be axe clean.