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

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

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

一部の画面では、関連付けられているテキストプロパティが誤って検出され、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)

タッチターゲットの間隔ルールは、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
//    }
}

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

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の機能を完全に解放するには、スクリーンショットを有効にしてください。セキュリティ上の懸念を避けるために、モックデータを使用するアプリのデバッグまたはテストバージョンでスクリーンショットを有効にすることをお勧めします。詳細は 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'つ見つかりました」といったエラーが発生した場合や、「ビューが初期化されていません。AxeDevToolsCompose.setComposeTestRule()を呼び出しましたか？」といったエラーが発生した場合は、 Compose setTestTag APIを参照してください。

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

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

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

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

• Android - FLAG_SECURE

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