Axe DevTools Mobile 2024年10月8日 リリースノート
2024年10月8日
コンポーネントバージョン
- Android SDK (axe-devtools-android v5.6.0)
- Android アナライザー (Axe Accessibility Analyzer v1.9.0)
- Android Appium ドライバー (axe-appium-uiautomator2-driver v1.1.0)
更新方法: Android SDK、Android アナライザー Android Appium ドライバー
新機能
アクセシブルアクションルール
非アクティブアクセス可能ビューを、iOSのルール名に合わせてアクセシブルアクションに名前を変更しました。このルールを実験的とすることに決め、両プラットフォームでの結果の精度を向上させることを目指しています。
修正
- 次のルールのパフォーマンスと精度を向上させるための更新: 色のコントラスト、タッチターゲットサイズ、名前にラベル、前面のラベル、編集テキストの名前、入れ子になったアクティブコントロール
- デバッグのために、タッチターゲットスペーシングルールの分析値に重なっているビューのクラス名を追加
- 結果の説明をより詳しくし、アクセシブルアクションおよび前面のラベルルールの問題を修正するための改良されたガイダンスを提供
- アクセシビリティサービスの安定性と信頼性を向上させました。アプリを使用するたびに許可を再度求めることはなくなります
- ダッシュボードへの結果アップロードのためのネットワークリクエストを最適化
- Appium ドライバーでの認証エラーメッセージ処理を改善
非推奨項目
十分な検討の末、将来的にXMLとCompose APIが廃止されることになるAndroid向けAxe DevToolsの簡素化された実装に向けて動いています。この移行は一夜にして行われるものではありませんが、レイアウトに依存しないAPIへの段階的な移行をお勧めします。そうすることで継続的なサポートと最新の更新へのアクセスが可能となります。
既知の問題
以下の問題が発生している場合は、helpdesk@deque.comまたはsupport.deque.comにご連絡ください。問題が解決した際や解決策が見つかった場合にはご通知します。
- Axe DevTools Mobileの自動テストは、ネイティブiOS、ネイティブAndroid、React Nativeアプリで実行されます。あなたの技術スタックに合ったアクセシビリティテストソリューションについては、Dequeの担当者にお問い合わせください。
- WebビューやレンダリングされたPDFからもいくつかの結果を得られるかもしれませんが、最も包括的なウェブアクセシビリティテストにはAxe DevTools for WebまたはAxe Monitorを使用することを強くお勧めします。
iOS
AnalyzerプロジェクトとバンドルIDによるテストでのエラー（v2.8.1）
バンドル識別子によるアプリケーションのテストの機能がバージョン2.8.1で壊れており、「テスト構成を介して指定された対象アプリケーションパスがありません…」というエラーが発生しました。エラーを解決するために、2.8.2以上に更新してください。 iOS Analyzerプロジェクト内で最新バージョンに更新してください。
SwiftUI & クロスプラットフォームアプリでの誤検知: ラベルインネームと前面のラベル
一部の画面では、関連付けられているテキストプロパティの誤検出により、ラベルインネームや前面のラベルについての誤検知が報告される可能性があります（#1622）
iOS 15 Proシミュレータで動作しないダイナミックタイプサポートルール
iPhone 15 Proシミュレータに影響を及ぼす問題があり、ダイナミックタイプサポートルールを実行できません。ダイナミックタイプサポートルールに登録されている場合、iPhone 15 Proシミュレータを使用してテストできません。Appleにバグ報告が送信されています。
ネストされたコントロールに対するルール
ルール改善の検討中に、XCTestではネストされたコントロールがアクセシビリティツリーに返されないことが判明しました。この問題については、Appleにバグ報告が送信されています。（#1110）
UIKitアプリでのImageView名ルール評価結果が要確認として報告される
UIKitアプリでは、`accessibilityLabel`がない画像はデフォルトでは支援技術でフォーカスできません。
Appleから使用するプロパティが、画像に`accessibilityIdentifier`が設定されている場合に不正確である可能性があります。この予期しない動作のため、UIKitアプリでのImageView Name問題の結果は要確認として報告されます。Appleにバグ報告が送信されています。（#1633）
誤検知: スクロールビュー、ラベルインネーム、前面のラベル、およびv2.11.0でのImage View Name & ActiveControlName
以下の誤検知についての修正を積極的に進めており、修正が解放され次第リストを更新します。
In Scroll View
バナーとして振る舞う要素内のテキストに関して報告される可能性があります。それらの要素を必要とする人がより大きなテキストを利用できるようにするために、 UILargeContentViewer。#622
v2.11.0 Image View Name & Active Control Name
UIImageViewに`accessibilityIdentifier`が設定されているがVoiceOverによってフォーカスされない場合、内部にフォーカス可能なコントロールがネストされていると、ActiveControlNameがUIImageViewに対して偽のポジティブを報告することがあります。この問題は`accessibilityIdentifier`を削除することで解決されます。Appleにバグが報告されています。（#1633）
Label In Name and Label At Front
これら二つのルールは、コントロールの可視ラベルを近傍の要素から探し、ルールのステータスを判断するのに役立ちます。一部のビュー階層では、誤った近傍テキストが検出され、これらのルールが失敗する原因になることがあります。（#1622）
Android
アナライザーアプリ：フローティングアクションボタンが消える
API 31（Android 12）で導入された新機能として、非システムオーバーレイを隠す能力があります。Axe Analyzerアプリを利用するために、この設定がオンになっていないことを確認してください。この機能をセキュリティ強化のために使用している場合は、テストデータを安全に使用し、セキュリティ上の懸念を排除できる内部テストビルドでは、それをオフにしておくことをお勧めします。 Note: this setting does not affect Google's accessibility scanner app as it's considered a system overlay.
Axe Accessibility Analyzer アプリを利用するために、メソッドへの呼び出しを更新してください。 setHideOverlayWindows(true) に setHideOverlayWindows(false) 。
ダッシュボードでスクリーンショットが見つからない（ブラックボックス）
Axe DevTools for Mobileのすべての機能を解放するには、スクリーンショットが有効になっていることを確認してください。スクリーンショットをデバッグまたはテスト版のアプリでモックデータを使用して有効にすることをお勧めします。これによりセキュリティの懸念を避けられます。詳細については、ガイドをチェックしてください。 Androidアプリでスクリーンショットを有効にする方法
`minifiedEnabled` がtrueに設定されているとクラッシュする
ビルドを最小化すると、Axe DevToolsライブラリにログインしようとする際にアダプターが見つからないと報告するエラーログと共にクラッシュが発生します。Axe DevToolsを実装したデバッグビルドでは最小化を無効にしてください。（#729）
r8が有効になっているビルドでエラーが発生する
r8が有効になっているビルドは、axeDevToolsライブラリを縮小化しようとして、以下のようなエラーが発生することがあります：
Caused by: java.lang.NullPointerException: throw with null exception
at g.b.b.a$a.a(Unknown Source:1)
at g.b.b.a$a.a(Unknown Source:0)
at g.b.b.a.a(AccessToken.java:190)
To resolve this error add the following line to your ProGuard file to keep axeDevTools classes:keep class com.deque.** { *; }
次のようなエラーメッセージ：
Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)
または： No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?
Compose APIは非推奨ですので、 レイアウトに依存しないAPI を使用して更新を受け取り続けてください。Compose APIを使用し続け、「期待されるノードは '1' つですが、'2' つのノードが見つかりました（isRootに一致）」や「Viewが初期化されていません。AxeDevToolsCompose.setComposeTestRule()を呼び出しましたか？」のようなエラーが発生した場合、 Compose setTestTag APIを参照してください。
ログメッセージ：MlKitContext has not been initialized
このメッセージに遭遇した場合、一部のルールの結果が期待通りに返されない可能性があります。該当するルールには、色のコントラスト、フォーカス可能なテキスト、ネストされた要素名があります。（#841）
MAUI: テキスト編集名規則
AndroidエコシステムでのMAUIアプリアーキテクチャの制限により、SDKバージョン5.5.0以降では障害が疑われる場合、テキスト編集名規則がダッシュボードで要確認として表示されます。このケースは手動で正しい動作を確認してください。
ネイティブAndroid: カスタムダイアログ/モーダル
カスタムダイアログやモーダルを実装していて、ネイティブコントロールを拡張していない場合、モーダルの背後にあるビューの結果が得られることがあります。この場合、これらのカスタムモーダルやダイアログに対してツールを実行せず、手動で確認して、支援技術が望まれるように動作することを確認することをお勧めします。
Webダッシュボード
スクリーンショットが見つかりません
スキャン詳細ページからスクリーンショットが欠落している場合、アプリがスクリーンショットの撮影を妨げている可能性があります。多くの場合、これは本番用アプリケーションにおいてセキュリティ上の理由によるものです。Axe DevTools Mobile Dashboardの完全な機能を利用するために、テストビルドに対するこの要件を削除することを検討してください。
一部のAndroidスキャン名がフォーマットされていない
画面タイトルにデフォルト設定された一部のAndroidスキャン名は、バンドル識別子を含むクラス名全体として表示されます。将来のリリースでは、画面タイトルがより読みやすい名前にフォーマットされるようになります。対策としては、ダッシュボードまたはフレームワークからスキャン名を設定することができます。（#1643）