Axe DevTools Mobile 2025年9月24日リリースノート

iOS 26には、デフォルトのステッパーのボタンがAssistive Technologyによって„無効化“と通知されないアクセシビリティバグがあります。このため、iOSのルールでも無効な場合でもこれらのボタンを有効と見なします。Appleにバグレポートを提出しましたが、これが解決されるまで、以下のルールが無効なステッパーのボタンに対しても結果を報告する可能性があります： AssociatedText、 InaccessibleAction、および ColorContrastを参照してください。

Appleがこのバグを修正するまでの解決策は[ルールを無視する](ios-ignore-rule)ことです。デフォルトステッパーのボタンには„Decrement“および„Increment“という識別子があり、必要に応じて識別子で無視することができます。

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で壊れており、次のエラーが発生しました： "No target application path specified via test configuration: ..."。これを解決するには、2.8.2または最新バージョンに更新してください。 iOS Analyzerプロジェクト内の最新に更新してください。

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

一部の画面では、#1622に関連して誤ったassociatedTextプロパティが見つかったため、「LabelInName」と「LabelAtFront」で誤検出が報告される場合があります。

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テキスト検出が必要です。Axe DevTools Mobileを自動化して使う際、EspressoやUIAutomatorテストを参照する時にML Kitライブラリが自動的にインポートされるはずですが、場合によっては自動インポートが行われず、ログキャットに次のエラーが表示されます。

この問題を解決するには、ML Kit ライブラリをプロジェクトに手動でインポートする必要があります。アプリケーションの build.gradle ファイルで、dependencies の下に次を追加します：

タッチターゲット間隔ルールは、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レベルでローカルに保存する際に問題を引き起こすため、API 30でのみコメントアウトしてください。

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

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 for Mobileの完全な機能をアンロックするためには、スクリーンショットを有効にしてください。セキュリティ懸念を避けるために、モックデータを使用したデバッグまたはテストバージョンのアプリでスクリーンショットを有効にすることをお勧めします。当社のガイドをご覧ください。 スクリーンショットを有効にする方法について私たちのガイドをチェックしてください。

ビルドを縮小していると、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)
このエラーを解決するには、ProGuard ファイルに次の行を追加して axeDevTools クラスを保持します：
keep class com.deque.** { *; }

Compose API は非推奨です。引き続きアップデートを受け取るには、 レイアウトに依存しない API をご使用ください。Compose API を引き続き使用し、`Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` または `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?` のようなエラーが発生した場合は、 Compose setTestTag APIを参照してください。

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

Androidエコシステム内でのMAUIアプリのアーキテクチャの制約により、SDKバージョン5.5.0以降の場合、テキスト名編集ルールはダッシュボードで再確認が必要として表示されます。この場合、手動で正しい動作を確認してください。

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

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

• Android - FLAG_SECURE

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