既知の問題

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

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

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

iOS 26には、デフォルトのステッパーボタンが「dimmed」とアシスティブテクノロジーによって通知されないアクセシビリティバグが含まれています。その結果、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.

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

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

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

UIKitアプリでは、 `accessibilityLabel` なしの画像はデフォルトでアシスティブテクノロジーでフォーカスできません。
Imageの `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がビューから情報にアクセスできるようになり、ツールが情報を検出できるようになります。

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

Hintテキスト機能を利用するXMLで書かれたアプリは、 EditTextName ルールで誤検出を受ける可能性があります。HintテキストはAndroid 8 (SDK 26)まで導入されていません。あなたのXMLアプリでこの要素を使用すると、Hintテキストがテキスト入力フィールドの値に割り当てられます。より最近のAndroidバージョンは、より良いアクセシビリティ体験を提供するようになっています。

この問題を克服するために、まず新しいバージョンのAndroidでテストを実行することをお勧めします。ただし、アプリが以前のAndroidバージョンでもアクセシブルであることが重要な場合は、 hintText 機能は、正式にサポートされていないためです。

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

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

正確な結果を保証するために、多くの axe DevTools Mobile のルールで ML Kit テキスト検出が必要です。自動化された Espresso または UIAutomator テスト内で 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 アナライザーアプリを利用するには、この設定がオンになっていないことを確認してください。この機能をセキュリティ強化のために利用することを選択した場合、内部テストビルドではテストデータを安全に利用してセキュリティの懸念を排除することで、この設定をオフにしておくことをお勧めします。 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 API を使用し続け、「(isRoot) に一致するノードがちょうど '1' 個必要ですが、'2' 個のノードが見つかりました」や「ビューが初期化されていません。AxeDevToolsCompose.setComposeTestRule() を呼び出しましたか？」のようなエラーに直面した場合は、こちらを参照してください Compose setTestTag API。

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

ネイティブコントロールを拡張しないカスタムダイアログまたはモーダルを実装している場合、モーダルの背後にあるビューの結果が得られる可能性があります。この場合、これらのカスタムモーダルまたはダイアログに対してはツールを使用しないことをお勧めし、代わりに手動で確認して、支援技術で目的通りに動作することを保証してください。

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

• Android - FLAG_SECURE

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