Axe DevTools Mobile 2026年2月4日リリースノート

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

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

AppleのアクセシビリティAPIは、WKWebView内のWebコンテンツを「isVisible」と誤って報告することがあります。これは、Webビューがネイティブオーバーレイ（モーダルビュー、アラート、その他のネイティブUI要素など）に覆われている場合でも同様です。これは、アクセシビリティシステムが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.

一部の画面では、LabelInNameおよびLabelAtFrontに誤ったassociatedTextプロパティが見つかるため、誤検知が報告される可能性があります (#1622)

iPhone 15 Proシミュレータに影響を与える問題があり、サポートされる動的タイプルールが実行されません。サポートされる動的タイプルールに参加している場合、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)

いくつかのケースでは、支援技術は AccessibilityEvent Androidシステムからの説明に頼って、他に発表がない時にユーザーに情報を伝えます。 AccessibilityEvents are triggered by user actions, we are unable to access the correct description if this information is not provided.

この問題を避けるには、すべての関連するビューがアクセシビリティのために重要であるとマークされていることを確認してください。これにより、Talkbackはビューから情報にアクセスでき、ツールで検出可能になります。

私たちの色のコントラストルールは、テキストを検出するために機械学習に依存しており、それによりアプリケーションのユーザーに対してテキストが表示されることを保証します。ビューに含まれているテキストが背景と同じ色の場合、機械学習アルゴリズムはテキストが存在するかどうかを検出できないため、このビューでは色のコントラストルールは実行されません。

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

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

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

この複雑な問題に対する修正に取り組んでいます。現在のところ、TalkBackがこれらのビューにアクセスできない場合、対応する問題を無視してかまいません。それはアクセシビリティを確保するための修正を必要としません。

ML Kitのテキスト検出は、結果の精度を確保するために多くのaxe DevTools Mobileルールで必要です。axe DevTools Mobileを自動化されたEspressoやUIAutomatorテストで参照する場合、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 30のみに対してコメントアウトしてください。他のAPIレベルではローカル保存に問題を引き起こすことになりますので注意が必要です。

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

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アプリでスクリーンショットを有効にするためのガイドをご覧ください。 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）

MAUIアプリアーキテクチャの制約により、Androidエコシステムでレンダリングする際、テキスト名編集ルールはSDKバージョン5.5.0以上でエラーが疑われる場合にダッシュボードで「レビューが必要」と表示されます。この場合、正しい動作を手動で確認してください。

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

スキャン詳細ページからスクリーンショットが欠落している場合、アプリがスクリーンショットの撮影を防いでいる可能性があります。通常この要件は製品アプリケーションのセキュリティ理由のためです。テストビルドではこの要件を削除し、axe DevTools Mobileダッシュボードでの全機能を可能にすることを検討してください。

• Android - FLAG_SECURE

画面タイトルにデフォルトされた一部のAndroidスキャン名は、バンドル識別子を含む完全なクラス名として表示されます。今後のリリースでは、画面タイトルがより読みやすい名前にフォーマットされるように解決されます。代替方法として、ダッシュボードやフレームワークからスキャン名を設定できます。（#1643）