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

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

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

AppleのアクセシビリティAPIが、WKWebView内のウェブコンテンツを「isVisible」と誤って報告することがあります。これは、ウェブビューがネイティブオーバーレイ（モーダルビュー、アラート、その他のネイティブUI要素など）で覆われている場合でも発生します。この問題は、アクセシビリティシステムがWKWebViewコンテナ自体が可視であるかをチェックし、ウェブコンテンツそのものが遮られていないかを確認しないために起きます。

iOS 26には、デフォルトのステッパーボタンがAssistive Technologyによって「ディム」として発表されず、それが有効でないことを示すアクセシビリティバグがあります。その結果、iOSのルールもこれらのボタンを無効であっても有効として見ます。この問題が解決されるまで、次のルールは無効なステッパーボタンに関する結果を報告するかもしれません： 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.

いくつかの画面では、不正確なassociatedTextプロパティが見つかり、LabelInNameおよびLabelAtFrontの誤検出が報告されることがあります（#1622）

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の新しいバージョンでは、このエクスペリエンスをよりアクセスしやすくすることができます。

この問題を解決するために、最初にお勧めするのはアンドロイドの新しいバージョンを使用して検証を行うことです。ですが、アプリが以前のアンドロイドバージョンでもアクセスできることが重要である場合、 hintText の使用を避けることを検討してください。なぜなら、公式にはサポートされていないからです。

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

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

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

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

タッチターゲット間隔ルールは、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 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アプリでスクリーンショットを有効にする方法。

ビルドを縮小すると、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を使用し続け、「(isRoot) を満たすノードが '2' つありますが、正確に '1' つである必要があります」または「ビューが初期化されていません、AxeDevToolsCompose.setComposeTestRule() を呼び出しましたか？」のようなエラーが発生した場合は、 Compose setTestTag API。

このメッセージが表示された場合、そのルールが人工知能を利用しているときに、いくつかのルールの結果が期待通りに返されない可能性があります。影響を受けるルールには、色のコントラスト、フォーカステキスト、ネストされた要素名が含まれます。（#841）

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

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

スキャン詳細ページにスクリーンショットが表示されない場合、アプリがスクリーンショットの撮影を防止している可能性があります。これは通常、本番アプリケーションでのセキュリティ上の理由からです。テストビルドでこの要件を削除し、Axe DevTools Mobile Dashboardでフル機能を利用できるようにすることを検討してください。

• Android - FLAG_SECURE

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