Axe DevTools for Web v4.xへの移行(Java向け)
Java向けAxe DevTools for Webのバージョン4.xへの移行手順
Not for use with personal data
Axe DevTools for Web Maven v4.xは、プロジェクト全体の大規模な再設計です。以下に、主な変更点をまとめた後、関連パッケージのより具体的な変更点を紹介します。
概要
axe-devtools-*のJavaパッケージ群は、製品提供を再ブランド化する視点と、提供された統合ツールを開発者の経験により特化させるためにスリム化する必要がありました。
これを念頭に置いて、以前のバージョンでは単一のパッケージのみが提供されていたのに対し、このバージョンでは複数のパッケージが提供されており、エンドユーザーは現在のワークフローに最適かつ必要なものを選択できます。
important
破壊的な変更に注意。モノリシックなパッケージ構造から個々のモジュール構造への分割とAPIの再ブランド化に伴い、v4.0への移行にはこの移行ガイドをステップごとに従う必要があります。
環境設定
デフォルトの環境要件に変更はありません。望ましい要件は以下の通りです:
Axe DevToolsパッケージのインストール
利用可能なオプションのいずれかを介してAxe DevToolsにアクセスできることを確認してください。
セッパ成功後、pom.xmlファイルに含めることで、以下のいずれかのパッケージをインストールできます。
DequeのAgoraからseleniumパッケージをインストールする例:
<dependency>
<groupId>com.deque.html.axe-devtools</groupId>
<artifactId>selenium</artifactId>
<version>4.x.x</version>
</dependency>利用可能なパッケージは以下の通りです:
上記の各パッケージの使用説明と詳細なAPIドキュメントを参照してください。
注目すべき変更点
パッケージのインストールと使用法の変更以外にも、以下の注目すべき変更があります:
- Javaパッケージの名前空間が
com.deque.attestからcom.deque.html.axedevtoolsに変更されました。 AttestクラスがAxeSeleniumに名前変更されました。- カスタムルールを設定するための環境変数が
ATTEST_PATHからAXE_RULESET_PATHに変更されました。 - デフォルトのルールセットが変更されました。Axe DevToolsは、デフォルトのルールセットとして
wcag2.1を使用して指定されたページを監査します。エンドユーザーによる変更は必要ありません。別のルールセットを設定したい場合は、Cucumber/ RSpecで提供されるそれぞれの節を使用できます。
