axe DevTools Mobile 2025年11月6日リリースノート

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

iOS 26には、デフォルトのステッパーボタンが有効でないことを示すためにAssistive Technologyで「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.

iOS Analyzer 1.4.7での設定により、スキャンが実行されず、「テスト失敗」というメッセージが返されます。物理デバイスでスキャンを実行するには、 最新のiOS Analyzerプロジェクトに更新してください。

バージョン2.8.1ではバンドル識別子によるアプリケーションのテスト機能が壊れ、「 "No target application path specified via test configuration: ..."」というタイトルのエラーが発生していました。エラーを解決するには、2.8.2または最新バージョンに更新してください。 最新のiOS Analyzerプロジェクトに更新してください。

このバージョンのアナライザーとSDKで一部のアプリケーションをスキャンすると、「 "Could not Serialize AxeResult" 」というエラーが発生していました。エラーを解決するには、最新バージョンに更新してください。 最新のiOS Analyzerプロジェクトに更新してください。最新のiOS SDKに更新してください。

Some screens may報告します、誤検知: an incorrect associatedText property being found (#1622)。

動的タイプサポートルールの実行を妨げるiPhone 15 Proシミュレーターに影響を与える問題があります。動的タイプサポートルールにオプトインしている場合、iPhone 15 Proシミュレーターを使用してテストすることはできません。Appleにバグが報告されています。

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

UIKitアプリでは、 accessibilityLabel がない画像は、デフォルトで支援技術ではフォーカスされません。
Apple から取得した可視性を確認するためのプロパティは、画像に accessibilityIdentifier が設定されている場合、不正確である可能性があります。この予期しない動作により、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)

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

ヒントテキスト機能を利用しているXMLで書かれたアプリは、 EditTextName のルールで偽陽性が発生する可能性があります。ヒントテキストはAndroid 8 (SDK 26) から導入されました。この要素をXMLアプリで使用すると、ヒントテキストはテキスト入力フィールドの値に割り当てられます。より新しいバージョンのAndroidは、この体験をよりアクセシブルにするための準備が整っています。

この問題を解決するための最初の推奨は、より新しいバージョンのAndroidでテストを実行することです。しかし、アプリが古いAndroidバージョンでもアクセシブルであることが重要である場合、この hintText 機能を使用しないことを検討してください。公式にはサポートされていません。

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

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

多くのaxe DevTools Mobile ルールで結果の正確性を確保するためにML Kit テキスト検出が必要です。axe DevTools Mobile を自動エスプレッソまたはUIAutomatorテストに参照するとき、ML Kit ライブラリは自動的にインポートされるべきです。ただし、一部のケースでは、自動インポートが行われず、ログキャットに以下のエラーが表示されます:

この問題を解決するには、ML Kit ライブラリを手動でプロジェクトにインポートする必要があります。アプリケーションの build.gradle ファイルに、次の内容を依存関係の下に追加してください:

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

Android API 30 では、ローカルに結果を保存しようとする場所の1つで、権限エラーが発生します。このエラーが表示されても、結果はJSONファイルとして保存されます。このエラーは、次のブロック内のコードをコメントアウトすることで無視できます。
def clearDirectoryTask = task('clearDirectoryTask', type: Exec, group: 'reporting') {
executable "${android.getAdbExecutable().toString()}"
args 'shell', 'rm', '-r', '/storage/emulated/0/Documents/AxeTestCases'
// finalizedBy {
// fetchAndroidFolderAxeReportsTask
// }
}

このコードは API 30 のみでコメントアウトされるべきであることに注意してください。他のAPIレベルでは、ローカルに保存する際に問題を引き起こします。

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

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)
このエラーを解決するには、ProGuard ファイルに次の行を追加して、axeDevTools クラスを保持してください:
keep class com.deque.** { *; }

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

このメッセージに遭遇した場合、そのルールで人工知能が使われている場合に、いくつかのルール結果が期待通りに返らないことがあります。影響を受けるルールは、色のコントラスト、フォーカス可能なテキスト、および入れ子の要素名を含みます。 (#841)

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

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

スキャンの詳細ページにスクリーンショットがない場合、アプリがスクリーンショットの取得を防いでいる可能性があります。これは多くの場合、製品アプリケーションのセキュリティ上の理由です。テストビルド用にこの要件を削除して、axe DevTools Mobile Dashboardの完全機能を許可することを検討してください。

• Android - FLAG_SECURE

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