Axe DevTools Mobile 2026年5月18日リリースノート

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

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

AppleのアクセシビリティAPIは、WKWebView内のウェブコンテンツを“isVisible”と誤って報告することがあります。これは、ウェブビューがネイティブオーバーレイ（モーダルビュー、アラート、その他のネイティブUI要素など）によって覆われている場合でも発生します。これは、アクセシビリティシステムがWKWebViewコンテナ自体が表示されているかどうかをチェックするためであり、そのウェブコンテンツが実際に妨げられていないか、ユーザーに知覚可能かを判断していません。

iOS 26には、デフォルトのステッパーボタンが「ディムド」と案内されず、利用可能ではないことを示すアクセシビリティバグがあります。その結果、iOSルールではこれらのボタンが有効と見なされます。Appleにバグ報告が提出されていますが、この問題が解決されるまでは、以下のルールが無効なステッパーボタンについて結果を報告するかもしれません: AssociatedText、 InaccessibleAction、および ColorContrast。

Appleがこのバグを修正するまでの解決策としては、[ルールを無視する](ios-ignore-rule)ことです。デフォルトのステッパーボタンは「減少」と「増加」の識別子を持ち、必要に応じて識別子で無視することができます。

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`がない画像はデフォルトでアクセシビリティテクノロジーでフォーカス可能ではありません。
画像に`accessibilityIdentifier`が設定されている場合、Appleからのフォーカス可能性を確認するためのプロパティが不正確になる可能性があります。この予期しない動作により、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を参照する際には、通常、ML Kitライブラリが自動的にインポートされるべきですが、場合によっては自動インポートが行われず、logcatに以下のエラーが表示されます：

Axe DevTools Android: Error while running mlKit Text Detection: MlKitContext has not been initialized.

この問題を克服するためには、ML Kitライブラリを手動でプロジェクトにインポートする必要があります。アプリケーションの build.gradle ファイルの依存関係の下に次を追加します：

debugImplementation 'com.google.mlkit:text-recognition:16.0.1'

タッチターゲット間隔ルールは、現在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'

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

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) 対象のアクティビティウィンドウに対して行います。

Mobile版のAxe DevToolsの機能を完全に活用するには、スクリーンショットが有効になっていることを確認してください。セキュリティ上の懸念を避けるために、モックデータを使用したデバッグまたはテストバージョンのアプリでスクリーンショットを有効にすることをお勧めします。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)
	

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を参照してください。

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

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

スキャン詳細ページにスクリーンショットが欠けている場合、アプリがスクリーンショットの撮影を妨げている可能性があります。これはしばしば、製品版アプリケーションでのセキュリティ上の理由によるものです。テストビルドでこの要件を削除して、Axe DevTools Mobileダッシュボードで完全な機能を利用できるようにすることを検討してください。

• Android - FLAG_SECURE

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