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)

v2.11.0 Image View Name & Active Control Name
UIImageViewに`accessibilityIdentifier`が設定されており、VoiceOverでフォーカスできず、その中にフォーカス可能なコントロールがネストされている場合、UIImageViewに対してActiveControlNameが誤検知を報告する可能性があります。`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がビューから情報にアクセスでき、私たちのツールがその情報を検出できます。

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

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

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

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

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

結果の正確性を保証するために、多くのaxe DevTools MobileルールでML Kitのテキスト検出が必要です。テスト自動化用のEspressoやUIAutomatorを参照している場合、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アクセシビリティアナライザーアプリを使用するには、メソッドの呼び出しを 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)
	

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）