Axe DevTools Mobile 2026年6月17日リリースノート

色コントラストルールは、AppleのVisionフレームワーク（光学文字認識、またはOCR）を使用して要素の境界内のテキストを読み取ります。OCRは時折、小さなアイコンのようなグリフ（例えば、戻る矢印のシェブロン(<)、箇条書き、装飾記号）をテキストと誤認識することがあります。その際、読み取り可能なテキストを含まない要素に対して色コントラストルールが実行され、アイコンのみのボタンに対して結果が生成される可能性があります。OCR出力がスキャンごとに決定的ではないため、同じ要素があるスキャンでは色コントラストの結果に現れ、次のスキャンでは「適用不可」と報告されるかもしれません。これはOCRの特性であり、ルールのバグではありません。

この問題を回避するには、影響を受けた要素の色コントラストの結果を抑制する ignore APIを使用できます。

Flutterは AppBar.title をネイティブのスクリーンタイトルプロパティにマッピングしません。 UIViewController.title、そのため、スクリーンタイトルのルールがすべてのFlutter画面で、説明的なタイトルがあるかどうかにかかわらず失敗します。

これは、Flutterプラットフォームの制限として知られており、 flutter/flutter#185894。

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

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

AppleのアクセシビリティAPIは、WKWebView内のウェブコンテンツを「isVisible」と誤って報告することがあります。これは、アクセシビリティシステムが、WKWebViewコンテナ自体が可視であるかどうかをチェックするためであり、実際にそのウェブコンテンツが遮られておらずユーザーに認識可能かどうかを確認していないためです。

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.

一部の画面では、誤った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, #2077)

v2.11.0 Image View Name & Active Control Name
UIImageViewに accessibilityIdentifier が設定されているが、VoiceOverでフォーカスできない場合、そしてその中にフォーカス可能なコントロールがネストされている場合、Active Control NameがUIImageViewで誤検知する可能性があります。この accessibilityIdentifier を削除すると、問題が解決します。Appleにバグが報告されています。(#1633)

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

「連絡先アイコン」のようなビューで装飾的なテキストを使用する場合、アクセシビリティ問題を引き起こす可能性があります。テキストビューを使用して文字を表示し、希望する文字をベクトル画像として生成する代わりに、そのテキストビューをアクセシビリティに重要でないと宣言すると、アクセシビリティ違反が生じたかどうかを確実に判断することができません。

フォーカステキストを編集して2文字以下を無視する場合、多くの一語ボタン（例：「OK」、「No」、「Sí」）を誤って無視する可能性があります。これらの問題を避けるために、アイコンで表現したい単語から必要な文字を取得し、それを画像の一部として生成し、別々のテキストビューとして生成しないようにします。`FocusableText`はそのビューで動作しなくなります。

Flutterは AppBar.title をネイティブのスクリーンタイトルプロパティにマッピングしません。 Activity.setTitle、そのため、スクリーンタイトルのルールがすべてのFlutter画面で、説明的なタイトルがあるかどうかにかかわらず失敗します。

これは、Flutterプラットフォームの制限として知られており、 flutter/flutter#185894。

一部のケースでは、支援技術は AccessibilityEvent Androidシステムからの記述に依存して、他に利用可能なアナウンスがないときにユーザーへ情報をアナウンスします。しかし AccessibilityEventがユーザーの操作によってトリガーされるため、この情報が提供されない場合、正しい記述にアクセスできません。

この問題を避けるためには、関連するすべてのビューがアクセシビリティにとって重要であるとマークされていることを確認してください。これにより、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に表示されることがあります。

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

Android API 30では、ローカルに結果を保存しようとする場所の1つで、パーミッションエラーが発生します。このエラーが表示されるにもかかわらず、結果はJSONファイルとして保存されます。このエラーは次のブロック内のコードをコメントアウトすることで抑制できます。

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

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

ビルドを縮小（minify）した場合、Axe DevToolsライブラリへのログイン時にアダプタが見つからないというエラーログ付きでクラッシュが発生します。Axe DevToolsを実装したデバッグビルドではminifyを無効にしてください。（#729）

r8が有効化されたビルドは、axeDevToolsライブラリをミニファイしようとして、次のようなエラーを引き起こす可能性があります：

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。

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

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

スキャン詳細ページにスクリーンショットが欠落している場合、アプリがスクリーンショットの取得を妨げている可能性があります。多くの場合、これは本番アプリケーションでのセキュリティ上の理由によるものです。Axe DevTools Mobile Dashboardの全機能を有効にするために、この要件をテストビルドから削除することを検討してください。

• Android - FLAG_SECURE

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