axe DevTools Mobile 2025年11月26日 リリースノート

AppleのアクセシビリティAPIは、WKWebView内のWebコンテンツを「isVisible」として誤って報告する場合があります。これは、アクセシビリティシステムがWKWebViewコンテナ自体が表示されているかどうかを確認するためであり、そのWebコンテンツが実際に視界に入っており、ユーザーに認識可能であるかどうかを確認するものではありません。

iOS 26 には、デフォルトのステッパーボタンがAssistive Technologyによって「無効」と発表されないアクセシビリティバグがあります。そのため、iOSのルールではこれらのボタンを有効としても認識します。Appleにバグ報告をしていますが、解決するまで、以下のルールが無効なステッパーボタンに対して報告する可能性があります: AssociatedText、 InaccessibleAction、および ColorContrast。

Appleがこのバグを修正するまでの解決策は、[ルールを無視](ios-ignore-rule)することです。デフォルトのステッパーボタンには「Decrement」と「Increment」の識別子があり、必要に応じて識別子で無視することができます。

Our Color Contrast rule depends on Machine Learning to detect text, which ensures that the text being scanned is visible to users of your application. In cases where the text contained in a view is the same color as the background, our Machine Learning algorithm is unable to detect if any text is present, so the Color Contrast rule does not run on this view.

iOS Analyzer 1.4.7 では設定が原因でスキャンが実行されず「テスト失敗」と表示されます。物理デバイスでスキャンを実行するには、 最新のiOS Analyzerプロジェクトに更新してください。

バンドル識別子でアプリケーションをテストする機能がバージョン2.8.1で破損しており、「 "No target application path specified via test configuration: ..."」というエラーが発生しました。エラーを解決するには、2.8.2以降または最新バージョンに更新してください。 iOS Analyzer プロジェクト内の最新に更新してください。

このバージョンのアナライザーとSDKで一部のアプリケーションをスキャンすると、 "Could not Serialize AxeResult" エラーです。エラーを解決するには、最新バージョンにアップデートしてください。 最新のiOS Analyzerプロジェクトにアップデートしてください。最新のiOS SDKにアップデートしてください。

いくつかの画面では、#1622により、間違ったassociatedTextプロパティが見つかって誤検出が報告される可能性があります。

iPhone 15 Proシミュレータに影響を与える問題があり、Dynamic Typeルールが実行されません。Dynamic Typeルールにオプトインしている場合、iPhone 15 Proシミュレータを使用してテストすることはできません。Appleにバグ報告済みです。

私たちのルールの改善を検討していると、XCTestではネストされたコントロールがアクセシビリティツリーに返されないことが判明しました。Appleにバグ報告済みです。 (#1110)

UIKitアプリでは、 accessibilityLabel のない画像は、デフォルトでは支援技術でフォーカス可能ではありません。
Appleからフォーカス可能性をチェックするために使用するプロパティは、 accessibilityIdentifier が画像に設定されていると不正確な場合があります。この予期しない動作のため、UIKitアプリのImageView Name問題の結果はレビューが必要であると報告されます。Appleにバグ報告済みです。 (#1633)

これらの誤検出について修正をアクティブに行っており、修正がリリースされるたびにこのリストを更新します。

In Scroll View
バナービヘイビアエレメント内のテキストに問題が報告される場合があります。これらのエレメントをより大きなテキストが必要な方々に利用可能にするには、 UILargeContentViewerを使用してください。 (#622)

v2.11.0 Image View Name & Active Control Name
UIImageViewが accessibilityIdentifier セットされているにもかかわらずVoiceOverでフォーカス可能でない場合、かつインナービューにフォーカス可能なコントロールがネストされている場合、UIImageViewでActiveControlNameが誤検出を報告することがあります。 accessibilityIdentifier を削除すると問題が解決します。Appleにバグ報告済みです。 (#1633)

Label In Name and Label At Front
これらの2つのルールは、ルールの状態を判断するために、コントロールの表示されているラベルを近隣のエレメントの中から探します。一部のビュー階層では、誤った近隣のテキストが検出され、これらのルールの失敗を引き起こす可能性があります。 (#1622)

私たちのColor Contrastルールはテキストを検出するために機械学習に依存しており、アプリケーションのユーザーにとってテキストが見える状態であることを保証します。ビューに含まれるテキストが背景と同じ色の場合、機械学習アルゴリズムがテキストが存在するかを検出できず、このビューではColor Contrastルールが実行されません。

XMLで書かれたアプリでヒントテキスト機能を利用すると、 EditTextName ルールで誤検出が発生する可能性があります。ヒントテキストはAndroid 8 (SDK 26)で初めて導入されました。XMLアプリでこの要素を使用すると、ヒントテキストがテキスト入力フィールドの値に割り当てられます。より新しいバージョンのAndroidでは、このエクスペリエンスをよりアクセシブルにすることができます。

この問題を克服するために、私たちの最初の推奨は、テストをより新しいバージョンのAndroidで実行することです。しかし、古いバージョンのAndroidでもアプリがアクセス可能であることが重要な場合は、 hintText 機能の使用を避けることを検討してください。正式にはサポートされていません。

画面の他のビューの後ろに隠されているビューの結果が表示されることがあります。これらの隠されたビューは支援技術で利用できませんが、axe DevTools Mobileはそれらを問題として報告します。

この複雑な問題の修正に取り組んでいます。その間、TalkBackがこれらのビューに到達できない場合は、対応する問題を無視することができます。アクセシビリティを確保するための修正は不要です。

ML Kitテキスト検出は、多くのaxe DevTools Mobileルールで結果の正確性を確保するために必要です。自動化されたEspressoまたはUIAutomatorテストでaxe DevTools Mobileを参照する際、ML Kitライブラリは自動的にインポートされるべきですが、場合によっては自動インポートが行われず、logcatに次のエラーが表示されます：

この問題を克服するためには、ML Kitライブラリをプロジェクトに手動でインポートする必要があります。アプリケーションの build.gradle ファイルで、dependenciesの下に次のコードを追加してください：

Touch Target Spacingルールは、Jetpack Composeで書かれたスライダーコンポーネントでは現在実行されていません。現時点では特に対策は不要ですが、すぐに修正される予定です！

Android API 30で、ローカルに結果を保存しようとする場所の1つで権限エラーが発生します。このエラーが表示されてもJSONファイルとして結果は保存されます。このエラーは、次のブロック内のコードをコメントアウトすることで抑制できます：
def clearDirectoryTask = task('clearDirectoryTask', type: Exec, group: 'reporting') {
executable "${android.getAdbExecutable().toString()}"
args 'shell', 'rm', '-r', '/storage/emulated/0/Documents/AxeTestCases'
// finalizedBy {
// fetchAndroidFolderAxeReportsTask
// }
}

このコードは、他のAPIレベルでローカル保存する際に問題を引き起こすため、API 30の場合のみコメントアウトしてください。

一部のハイブリッドおよびクロスプラットフォームアプリでは、スクロールビュー内の項目が画面外に少しでも出ていると、予期しない結果が返されることがあります。アクセシビリティをテストするためには、スキャンを実行する前に要素が完全に画面上に表示されていることを確認してください。

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アプリでスクリーンショットを有効にする方法をご覧ください。

ビルドを縮小する場合、axe DevToolsライブラリにログインしようとすると、アダプターが見つからないというエラーログを伴うクラッシュが発生します。axe DevToolsが実装されているデバッグビルドでは縮小を無効にしてください。(#729)

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)
このエラーを解決するには、次の行をProGuardファイルに追加してaxeDevToolsのクラスを保持してください：
keep class com.deque.** { *; }

Compose APIは廃止予定ですので、 レイアウト非依存API を使用して更新を続けてください。Compose APIを継続使用し、`Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)`や`No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`のようなエラーが発生した場合は、 Compose setTestTag APIをご参照ください。

このメッセージが表示された場合、人工知能を使用しているルールでは、いくつかのルール結果が予想通りに返さないことがあります。影響を受けるルールは、カラーコントラスト、フォーカステキスト、およびネストされた要素名を含みます。(#841)

AndroidエコシステムでのMAUIアプリのアーキテクチャ制限により、SDKバージョン5.5.0以降で失敗が疑われる場合、このルールはダッシュボードで確認が必要と表示されます。このケースでは正しい動作を手動で確認してください。

ネイティブコントロールを拡張しないカスタムダイアログやモーダルを実装する際、モーダルの背後にあるビューに対する結果を取得する可能性があります。この場合、当社のツールをこれらのカスタムモーダルまたはダイアログに対して実行するのではなく、それらが支援技術と望ましい形で動作することを手動で確認することをお勧めします。

スキャン詳細ページにスクリーンショットがない場合、アプリがスクリーンショットの取得を妨げている可能性があります。これは、多くの場合、プロダクションアプリケーションにおけるセキュリティ理由によるものです。axe DevTools Mobile Dashboardで完全な機能を利用するために、テストビルドではこの要件を削除することを検討してください。

• Android - FLAG_SECURE

一部のAndroidスキャン名は、デフォルトで画面タイトルに設定されている場合、バンドル識別子を含む完全なクラス名として表示されます。将来のリリースでは、画面タイトルがより読みにくい名前としてフォーマットされるように解決されます。回避策として、ダッシュボードやフレームワークからスキャン名を設定できます。(#1643)