axe DevTools Mobile 2025年7月2日リリースノート

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で破損しており、「テスト設定経由で指定されたターゲットアプリケーションパスなし」というエラーが発生しました。エラーを解決するには、2.8.2または最新バージョンに更新してください。 iOS Analyzerプロジェクト内の最新バージョンに更新してください。

この版本のAnalyzerとSDKでいくつかのアプリケーションをスキャンすると、「AxeResultをシリアライズできませんでした」エラーが発生します。エラーを解決するには、最新バージョンに更新してください。 最新のiOS Analyzerプロジェクトに更新してください。最新のiOS SDKに更新してください。

いくつかの画面で、誤ったassociatedTextプロパティ検出により、LabelInNameおよびLabelAtFrontの誤検出が報告されることがあります (#1622)

iPhone 15 ProシミュレーターでSupports Dynamic Typeルールが実行できない問題があります。Supports Dynamic Typeルールに参加している場合、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のテキスト検出が必要です。自動化された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 ファイルで、依存関係の下に次を追加します:

implementation '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'
//    finalizedBy {
//        fetchAndroidFolderAxeReportsTask
//    }
}

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

Android 12（API 31）で導入された非システムオーバーレイを隠す機能を使用している場合、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)に一致するノードが'2'個見つかりましたが、'1'個であることを期待しました」または「ビューが初期化されていません。AxeDevToolsCompose.setComposeTestRule()を呼び出しましたか？」というエラーが発生した場合は、 Compose setTestTag APIをご参照ください。

このメッセージが表示された場合、人工知能を利用しているルールで一部の結果が期待通りに返らないことがあります。影響を受けるルールには、色のコントラスト、フォーカステキスト、ネストされた要素名が含まれます。 (#841)

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

ネイティブコントロールを拡張しないカスタムダイアログやモーダルを実装している場合、モーダルの背後にあるビューの結果が出ることがあります。この場合、これらのカスタムモーダルやダイアログに対してツールを実行するのではなく、望ましい形で補助技術に対応していることを確認するために手動でチェックすることをお勧めします。

スキャン詳細ページでスクリーンショットが欠落している場合、アプリがスクリーンショットの取得を妨げている可能性があります。これは、通常、本番アプリケーションにおけるセキュリティ上の理由によるものです。axe DevToolsモバイルダッシュボードでの完全な機能を利用するために、テストビルドのためにこの要件を削除することを検討してください。

• Android - FLAG_SECURE

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