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

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

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

Apple のアクセシビリティAPIは、WKWebView 内のウェブコンテンツを不正確に「isVisible」と報告することがあります。たとえウェブビューがネイティブオーバーレイ（モーダルビュー、アラート、その他のネイティブUI要素など）で覆われている場合でも、アクセシビリティシステムは WKWebView コンテナ自体が可視であるかを確認するだけで、ウェブコンテンツが実際に妨害されずユーザーに知覚可能かどうかは確認しません。

iOS 26 には、デフォルトのステッパーボタンが有効でないことを示す「dimmed」という状態を支援技術に対して発表しないアクセシビリティバグがあります。その結果、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)

Supports Dynamic Typeルールが実行されないiPhone 15 Proシミュレーターに影響する問題があります。Supports Dynamic Typeルールに参加している場合、iPhone 15 Proシミュレーターを使用してテストすることはできません。この問題についてはAppleにバグを報告しています。

私たちのルールを改善するために検討したところ、XCTestではネストされたコントロールがアクセシビリティツリーに返されないことがわかりました。この問題についてはAppleにバグを報告しています。（#1110）

UIKitアプリでは、`accessibilityLabel`がない画像はデフォルトで支援技術によるフォーカスができません。
Appleからのフォーカス可能性を確認するために使用しているプロパティが、画像に`accessibilityIdentifier`が設定されている場合、不正確である可能性があります。この予期しない動作により、UIKitアプリのImageView名の問題は「審査が必要」として報告されます。この問題については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）

場合によっては、支援技術が AccessibilityEvent Androidシステムの説明に依存して、他のアナウンスがないときに情報をユーザーにアナウンスします。そのため、 AccessibilityEventはユーザーの動作によってトリガーされるため、情報が提供されていない場合は正しい説明にアクセスできません。

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

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

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

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

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

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

ML Kit の文字認識は、Axe DevTools Mobile の多くのルールで結果の精度を確保するために必要です。ML Kit ライブラリは、Axe DevTools Mobile を参照する際に自動的に導入されるはずですが、一部の場合、自動的にインポートされず、logcat に以下のエラーが表示されます。

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

Android API 30では、結果をローカルに保存しようとする場所のひとつで権限エラーが発生しています。結果はこのエラーが表示されても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アプリでスクリーンショットを有効にする方法をご覧ください。

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

r8が有効なビルドでは、axeDevToolsライブラリを最小化しようとして次のようなエラーが発生する可能性があります:

Compose APIは非推奨です。次の レイアウトに依存しないAPI を使用して更新を受け続けてください。Compose APIsを使用し続け、「(isRoot)を満たすノードが『1』つだけ必要だが、『2』つのノードが見つかりました」や「Viewが初期化されていません。AxeDevToolsCompose.setComposeTestRule()を呼び出しましたか？」といったエラーに遭遇した場合は、次を参照してください： Compose setTestTag API。

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

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

スキャン詳細ページにスクリーンショットがない場合、スクリーンショットが撮影されないようアプリが制限している可能性があります。これは本番アプリケーションでのセキュリティ上の理由であることが多いです。Axe DevTools Mobile Dashboard の全機能を利用するために、テストビルドではこの制約を解除することを検討してください。

• Android - FLAG_SECURE

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