Axe DevTools Mobile 2025年5月21日リリースノート

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プロジェクト内で最新に更新してください。

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

一部の画面では、関連するテキストプロパティが誤って見つかったため、LabelInNameおよびLabelAtFrontで誤検知が報告されることがあります (#1622)

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

ルールの改善を検討している際に、XCTestで入れ子になったコントロールがアクセシビリティツリーに返されないことが判明しました。Appleにバグが報告されています。 (#1110)

UIKitアプリでは、`accessibilityLabel`がない画像はデフォルトで支援技術でフォーカスされません。
画像に`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)

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

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'

Touch Target Spacingルールは現在、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 31 (Android 12) から導入された機能として、非システムオーバーレイを隠すことが可能です。Axe アナライザーアプリを利用するには、この設定がオンになっていないことを確認してください。この機能をセキュリティ強化のために活用している場合、内部テストビルドではこの設定をオフにしてテストデータを安全に利用し、セキュリティの懸念を排除することをお勧めします。 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 の全機能を解除するには、スクリーンショットが有効になっていることを確認してください。セキュリティ上の懸念を避けるために、デバッグやテストバージョンのアプリでモックデータを使用してスクリーンショットを有効にすることをお勧めします。⟦0⟧のガイドをご確認ください。 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を参照してください。

このメッセージが表示される場合、そのルールが人工知能を利用しているとき、いくつかの結果が予想通りに戻らないことがあります。影響を受けるルールには、色のコントラスト、フォーカス可能なテキスト、およびネストされた要素名が含まれます。（#841）

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

ネイティブコントロールを拡張しないカスタムダイアログやモーダルを実装している場合、モーダルの背後にあるビューの結果が表示されることがあります。この場合、当社のツールをこれらのカスタムモーダルやダイアログに対して実行しないことをお勧めし、かわりに補助技術による期待通りの動作を手動で確認してください。

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

• Android - FLAG_SECURE

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