Migration zu Axe DevTools für Web v4.x für 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

Schritte zur Migration auf Version 4.x von Axe DevTools für Web für Ruby

Not for use with personal data

Axe DevTools für Web Gems v4.x ist eine komplette Neufassung des gesamten Projekts. Die bemerkenswertesten Änderungen sind unten zusammengefasst, gefolgt von spezifischeren Änderungen an relevanten Paketen.

Zusammenfassung

Die axe-devtools-* Suite von Gems wurde umstrukturiert, um die bereitgestellten Integrationswerkzeuge zu verschlanken und ein besseres Entwicklererlebnis zu bieten.

Im Vergleich zu früheren Versionen, bei denen nur ein einziges Gem bereitgestellt wurde, bietet diese Version eine Sammlung von Gems, die es Endnutzern ermöglicht, das auszuwählen, was wesentlich ist und am besten zu ihrem aktuellen Workflow passt.

Migrationsschritte

Aufgrund der Aufteilung von einer monolithischen Gem-Struktur zu einzelnen Gems sind einige Migrationsschritte erforderlich. Sie können den folgenden Migrationsleitfaden verwenden.

Entwicklerumgebung

Es gibt keine Änderungen an der vorherigen Entwicklerumgebung. Die erforderlichen Voraussetzungen sind wie folgt:

Ruby (die neueste Version)
Bundler für Gem-Abhängigkeiten
Rake als Task-Runner
RSpec oder Cucumber für Tests
Node und Npm zur Installation des axe-core Pakets

Installation von Axe DevTools für Web Gems

Stellen Sie sicher, dass Sie Zugang zu Deque's registry haben. Falls nicht, refer to the setup guide.

Nachdem Sie Zugang zum Deque-Register haben, können Sie eines der folgenden Gems installieren, indem Sie sie entweder in die Gemfile- oder gemspec-Dateien einfügen.

gem "axe-devtools-cucumber"

Alternativ können Sie eine Quelle für das Gem angeben:

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

Die verfügbaren Gems sind:

Bitte konsultieren Sie die Dokumentation für Benutzungsanweisungen und detaillierte Informationen zu den APIs.

Deinstallation der Ruby-Integrationen

Sie können die vorherigen Ruby-Integrationen deinstallieren, indem Sie die unten stehenden Befehle ausführen:

gem uninstall axe-matchers
gem uninstall attest-ruby

Bemerkenswerte Änderungen

Andere bemerkenswerte Änderungen an der Ruby-Integration umfassen:

Die Umgebungsvariable zur Konfiguration benutzerdefinierter Regeln wurde von ATTEST_PATH auf AXE_RULESET_PATH geändert. Siehe advanced usage.
Das Standard-Regelset hat sich geändert. Axe DevTools für Web prüft eine gegebene Seite mit wcag2 als Standard-Regelset. Es ist keine Änderung durch den Endnutzer erforderlich. Wenn Sie ein anderes Regelset konfigurieren möchten, können Sie die entsprechenden Klauseln in die Cucumber-Dokumentation oder die RSpec-Dokumentation verwenden.
Die be_accessible-Matcher in RSpec wurden in be_axe_clean umbenannt.
Die be accessible-Schrittdefinition in RSpec wurde in be axe clean umbenannt.