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

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アナライザー1.4.7の設定によりスキャンが実行されず、「テスト失敗」のメッセージが返されます。物理デバイスでのスキャンを実行するには、 最新のiOSアナライザープロジェクトに更新してください。

バンドル識別子によるアプリケーションのテスト機能がバージョン2.8.1で壊れており、「テスト構成ではターゲットアプリケーションパスが指定されていません：…」というエラーが発生しました。エラーを解決するには、2.8.2または最新バージョンに更新してください。 iOSアナライザープロジェクトを最新に更新してください。

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

一部のスクリーンでは、不正なassociatedTextプロパティが見つかるため、ラベルインネームとラベルアットフロントで偽陽性が報告される場合があります（#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）

当社のカラーコントラストルールは、機械学習に依存してテキストを検出します。これにより、アプリケーションのユーザーに表示されるテキストがスキャン対象であることを保証します。ビュー内のテキストが背景と同じ色である場合、機械学習アルゴリズムはテキストの有無を検出できず、このビューではカラーコントラストルールが実行されません。

ルールで誤検出が発生する可能性があります。ヒントテキストはAndroid 8（SDK 26）まで導入されていません。この要素をXMLアプリで使用すると、ヒントテキストがテキスト入力フィールドの値に割り当てられます。より新しいバージョンのAndroidではこの機能をよりアクセスしやすくするための改善が行われています。 EditTextName rule. Hint text was not introduced until Android 8 (SDK 26). Using this element in your XML app will assign the hint text to the value of the text input field. More recent versions of Android are better equipped to make this experience accessible.

機能の使用を避けることを検討してください。 hintText feature, as it is not officially supported.

画面上の他のビューの背後に隠れているビューの結果を見ることがあります。これらの隠れたビューは支援技術にアクセスできませんが、axe DevTools Mobileはそれらを問題として報告します。

この複雑な問題に対する修正に取り組んでいます。それまでの間、TalkBackがこれらのビューに到達できない場合、それに対応する問題は無視しても構いません。アクセシビリティを確保するために修正は必要ありません。

多くのaxe DevTools Mobileルールで、結果の正確性を確保するためにML Kitテキスト検出が必要です。axe DevTools Mobileを自動化されたEspressoまたはUIAutomatorテストで参照する際に、ML Kitライブラリは自動的にインポートされるべきですが、場合によっては自動インポートが行われないことがあり、logcatに次のエラーが表示されます：

Axe DevTools Android: Error while running mlKit Text Detection: MlKitContext has not been initialized.

ファイルで、以下をdependenciesの下に追加してください： build.gradle file, add the following under dependencies:

implementation 'com.google.mlkit:text-recognition:16.0.1'

タッチターゲットスペーシングルールは現在、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 Analyzerアプリを利用するには、この設定をオフにしておいてください。この機能をセキュリティ強化のために利用する場合でも、テストデータを安全に利用してセキュリティ問題を回避できる内部テストビルドではオフにしておくことをお勧めします。 Note: this setting does not affect Google's accessibility scanner app as it's considered a system overlay.

対象のアクティビティウィンドウで。 setHideOverlayWindows(true) to setHideOverlayWindows(false) on the affected activity windows.

スクリーンショットを有効化するためのガイドをチェックしてください。 enabling screenshots in Android apps.

ビルドを最小化すると、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)
    

を参照してください。 layout agnostic APIs to continue receiving updates. If you continue to use the Compose APIs and encounter an error along the lines of `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` or `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, please refer to Compose setTestTag API.

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

Due to limitations of the MAUI app architecture rendering in the Android ecosystem, the Edit Text Name rule will show as Needs Review in the dashboard when a failure is suspected for SDK version 5.5.0 and up. Please confirm correct behavior manually for this case.

When you're implementing custom dialogs or modals that do not extend the native controls, you may get results for views behind the modal. In this case, we recommend not running our tool against these custom modals or dialogs and instead manually checking them to ensure they behave with assistive technology as desired.

スキャン詳細ページにスクリーンショットがない場合、アプリがスクリーンショットの撮影を防止している可能性があります。しばしば、これは本番アプリケーションにおけるセキュリティの理由によるものです。axe DevTools Mobile Dashboardで完全な機能を利用できるようにするため、テストビルドではこの要件を削除することを検討してください。

• Android - FLAG_SECURE

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