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

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

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

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

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

• Android - FLAG_SECURE

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