Axe DevTools Mobile 2025年12月10日リリースノート

小さい画面サイズや小さいフォントサイズでアクセシビリティチェックを実行する場合、グラデーション背景に対してカラーコントラストルールが偽陽性を報告することがあります。このような場合、前景色を判定できず、代わりに背景色同士を比較し、不合格となることがあります。

この問題を回避するためには、大きなデバイスでアクセシビリティチェックを実行することを試みてください。または、テストでこのルールを無視し、これらのビューに対して手動でカラーコントラストを確認することができます。

AppleのアクセシビリティAPIは、WKWebView内のWebコンテンツを"isVisible"と誤って報告することがあります。これは、モーダルビューやアラート、他のネイティブUI要素などのネイティブオーバーレイでWebビューが覆われていても発生します。この問題は、アクセシビリティシステムがWKWebViewのコンテナ自体が表示されているかどうかをチェックし、そのWebコンテンツが実際にユーザーに認識可能であるかどうかを確認しないために発生します。

iOS 26には、デフォルトのステッパーボタンが「dimmed」とアナウンスされず、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.

一部の画面で、#1622の不正確なassociatedTextプロパティが見つかるため、LabelInNameとLabelAtFrontに関して偽陽性が報告されることがあります。

iPhone 15 Proシミュレーターに影響を与える問題が存在しており、Supports Dynamic Typeルールが実行されません。Supports 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によってフォーカスされず、フォーカス可能なコントロールがその内側にネストされている場合、ActiveControlNameがUIImageViewに対して偽陽性を報告することがあります。それを削除することで、 accessibilityIdentifier 問題が解決されます。Appleにはバグレポートが提出されています。（#1633）

Label In Name and Label At Front
これらの2つのルールは、ルールのステータスを決定するために、近くの要素からコントロールの目に見えるラベルを探します。一部のビュー階層では、誤った近くのテキストが検出されることがあり、これらのルールが失敗する原因となります。（#1622）

私たちのカラーコントラストルールは、機械学習に依存してテキストを検出し、アプリケーションの利用者にそのスキャンされるテキストが見えることを保証します。ビュー内に含まれるテキストが背景と同じ色の場合、機械学習アルゴリズムがテキストが存在するかを検出できず、このビューでカラーコントラストルールが実行されません。

ヒントテキスト機能を利用したXMLで書かれたアプリは、で偽陽性が出る可能性があります。 EditTextName ルール。ヒントテキストはAndroid 8（SDK 26）まで導入されていませんでした。XMLアプリでこの要素を使用すると、ヒントテキストがテキスト入力フィールドの値に割り当てられます。より新しいバージョンのAndroidは、この体験をよりアクセシブルにするように備えています。

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

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

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

精度を確保するために、多くのAxe DevTools MobileルールでML Kitのテキスト検出が必要です。自動化されたEspressoやUIAutomatorテストでAxe DevTools Mobileを参照する際に、自動的にML Kitライブラリがインポートされるはずです。しかし、場合によっては自動インポートが行われず、logcatに以下のエラーが表示されます:

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

タッチターゲットの間隔ルールは、Jetpack Composeで書かれたスライダーコンポーネントには現在実行されていません。現時点では対策はできませんが、修正は間もなく提供されます！

Android API 30では、ローカルに結果を保存しようとする場所の一つでパーミッションエラーが発生します。このエラーが表示されても、結果は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を実装したデバッグビルドではminifyを無効にしてください。（#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)
このエラーを解決するには、axeDevToolsのクラスを保持するために次の行をProGuardファイルに追加してください。
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）