Migratie naar Axe DevTools voor Web v4.x voor Ruby
Stappen voor migratie naar versie 4.x van Axe DevTools voor Web voor Ruby
Axe DevTools voor Web Gems v4.x is een volledige herziening van het hele project. De meest opvallende wijzigingen worden hieronder samengevat, gevolgd door specifiekere wijzigingen voor relevante pakketten.
Samenvatting
De axe-devtools-* suite van gems zijn opnieuw ontworpen om de verstrekte integratietools te vereenvoudigen en een betere ontwikkelaarservaring te bieden.
Vergeleken met eerdere versies, waar slechts één enkele gem werd geleverd, biedt deze versie een verzameling van gems waarmee eindgebruikers kunnen kiezen wat essentieel is en het beste past bij hun huidige workflow.
Migratiestappen
Aangezien de overstap van een monolithische gemstructuur naar individuele gems is gemaakt, zijn enkele migratiestappen vereist. U kunt de volgende migratiehandleiding gebruiken.
Ontwikkelaars Setup
Er zijn geen wijzigingen ten opzichte van de vorige ontwikkelaarssetup. De vereiste benodigdheden zijn als volgt:
- Ruby (de nieuwste versie)
- Bundler voor gem-afhankelijkheden
- Rake als een taakrunner
- RSpec of Cucumber voor testen
- Node en Npm voor het installeren van het axe-core pakket
Installeren van Axe DevTools voor Web Gems
Zorg ervoor dat u toegang heeft tot Deque's registry. Zo niet, dan refer to the setup guide.
Nadat u toegang heeft tot het Deque-register, kunt u een van de volgende gems installeren door ze op te nemen in de Gemfile of gemspec-bestanden.
gem "axe-devtools-cucumber"Als alternatief kunt u een bron voor de gem specificeren:
gem "attest-devtools-cucumber", :source => 'https://agora.dequecloud.com/artifactory/api/gems/devtools-gems'De beschikbare gems zijn:
- Axe DevTools for Web Cucumber
- Axe DevTools for Web RSpec
- Axe DevTools for Web Capybara
- Axe DevTools for Web Selenium
- Axe DevTools for Web Watir
Raadpleeg de documentatie voor gebruiksinstructies en gedetailleerde informatie over de API's.
De Ruby-integraties verwijderen
U kunt de vorige Ruby-integraties verwijderen door de onderstaande commando's uit te voeren:
gem uninstall axe-matchers
gem uninstall attest-rubyOpvallende Wijzigingen
Andere opmerkelijke wijzigingen in de Ruby-integratie zijn onder andere:
- De omgevingsvariabele voor het configureren van aangepaste regels is gewijzigd van
ATTEST_PATHnaarAXE_RULESET_PATH. Raadpleeg advanced usage. - De standaardregels zijn gewijzigd. Axe DevTools voor Web voert een audit uit op een gegeven pagina met
wcag2als de standaardregels. Er is geen wijziging vereist door de eindgebruiker. Als u een andere regels wilt configureren, kunt u gebruikmaken van de respectieve clausules die worden aangeboden in de Cucumber-documentatie of de RSpec-documentatie. - De
be_accessibleMatchers in RSpec zijn hernoemd naarbe_axe_clean. - De
be accessibleStapdefinitie in RSpec is hernoemd naarbe axe clean.
