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がこれらのビューにアクセスできない場合は、対応する問題を無視できます。アクセシビリティを確保するための修正は必要ありません。

ML Kitテキスト検出は、結果の正確性を保証するために多くのAxe DevTools Mobileのルールで必要とされます。ML Kitライブラリは、Axe DevTools Mobileを自動EspressoまたはUIAutomatorテストで参照すると自動的にインポートされるはずです。しかし、いくつかの場合で自動インポートが行われず、logcatに以下のエラーが表示されることがあります:

この問題を解決するには、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 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を実装したデバッグビルドでは縮小を無効にしてください。(#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)