Axe DevTools Mobile Veröffentlichungshinweise vom 10. Dezember 2025

Bei der Durchführung von Barrierefreiheitsprüfungen auf kleineren Bildschirmgrößen oder mit kleineren Schriftgrößen kann die Farbkontrastregel falsch positive Ergebnisse für Verlaufs-Hintergründe melden. In solchen Fällen ist es möglicherweise nicht möglich, die Vordergrundfarbe zu bestimmen und stattdessen werden Hintergrundfarben miteinander verglichen, was zu einem Fehler führt.

Um dieses Problem zu umgehen, versuchen Sie, Barrierefreiheitsprüfungen auf größeren Geräten durchzuführen. Alternativ können Sie die Regel in Ihren Tests ignorieren und den Farbkontrast manuell für diese Ansichten überprüfen.

Apples Barrierefreiheits-APIs können Webinhalte innerhalb von WKWebView fälschlicherweise als „isVisible“, auch wenn die Webansicht von nativen Overlays (wie modale Ansichten, Warnungen oder andere native UI-Elemente) überlagert wird. Dies geschieht, weil das Barrierefreiheitssystem prüft, ob der WKWebView-Container selbst sichtbar ist, anstatt ob sein Webinhalt tatsächlich unbehindert und für den Benutzer wahrnehmbar ist.

iOS 26 enthält einen Barrierefreiheit-Bug, bei dem die Standard-Buttons von Steppern nicht als „gedimmt“ durch Assistive Technologie angekündigt werden, um anzuzeigen, dass sie nicht aktiviert sind. Folglich sehen die iOS-Regeln diese Buttons auch dann als aktiviert an, wenn sie es nicht sind. Ein Bug-Bericht wurde bei Apple eingereicht, aber bis dies gelöst ist, können die folgenden Regeln Ergebnisse bei deaktivierten Stepper-Buttons melden: AssociatedText, InaccessibleActionund ColorContrast.

Bis Apple diesen Bug behebt, wird die Lösung darin bestehen, die [Regeln zu ignorieren](ios-ignore-rule). Die Standard-Buttons von Steppern haben die Bezeichner „Decrement“ und „Increment“ und können bei Bedarf durch Bezeichner ignoriert werden.

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.

Einige Bildschirme können falsche Positive mit LabelInName und LabelAtFront melden, da eine falsche associatedText-Eigenschaft gefunden wurde (#1622).

Es gibt ein Problem, das den iPhone 15 Pro-Simulator betrifft, das verhindert, dass die Supports Dynamic Type-Regel ausgeführt wird. Wenn Sie bei der Supports Dynamic Type-Regel angemeldet sind, können Sie sie nicht mit einem iPhone 15 Pro-Simulator testen. Ein Bug wurde bei Apple gemeldet.

Beim Ansehen einer Verbesserung für unsere Regeln haben wir festgestellt, dass in XCTest verschachtelte Steuerungen nicht im Barrierefreiheitsbaum zurückgegeben werden. Ein Bug wurde bei Apple gemeldet. (#1110)

In UIKit-Apps ist ein Bild ohne ein accessibilityLabel standardmäßig nicht mit assistiver Technologie fokussierbar.
Die Eigenschaften, die wir verwenden, um die Fokussierbarkeit von Apple zu überprüfen, können ungenau sein, wenn ein accessibilityIdentifier im Bild gesetzt ist. Aufgrund dieses unerwarteten Verhaltens werden die Ergebnisse für ImageView Name-Probleme in UIKit-Apps als "Überprüfung erforderlich" gemeldet. Ein Bug-Bericht wurde bei Apple eingereicht. (#1633)

Wir arbeiten aktiv an Korrekturen für die folgenden falschen Positiven und werden diese Liste aktualisieren, sobald Korrekturen veröffentlicht werden.

In Scroll View
Kann möglicherweise Probleme für Text innerhalb von Banner-verhaltensmäßigen Elementen melden. Um diese Elemente für diejenigen verfügbar zu machen, die größere Texte benötigen, verwenden Sie UILargeContentViewer. (#622)

v2.11.0 Image View Name & Active Control Name
Wenn ein UIImageView ein accessibilityIdentifier gesetzt hat, aber nicht von VoiceOver fokussierbar ist und es fokussierbare Steuerungen enthält, die in ihm verschachtelt sind, kann ActiveControlName ein falsch positives Ergebnis für das UIImageView melden. Das Entfernen des accessibilityIdentifier löst das Problem. Ein Bug wurde bei Apple gemeldet. (#1633)

Label In Name and Label At Front
Diese beiden Regeln suchen nach einem sichtbaren Label einer Steuerung unter nahegelegenen Elementen, um den Regelstatus zu bestimmen. In einigen Ansichts-Hierarchien kann der falsche nahegelegene Text erkannt werden, was dazu führt, dass diese Regeln fehlschlagen. (#1622)

Unsere Farbkontrastregel hängt von maschinellem Lernen ab, um Text zu erkennen, was sicherstellt, dass der gescannte Text für Benutzer Ihrer Anwendung sichtbar ist. In Fällen, in denen der Text in einer Ansicht die gleiche Farbe wie der Hintergrund hat, ist unser Algorithmus für maschinelles Lernen nicht in der Lage zu erkennen, ob Text vorhanden ist, und daher wird die Farbkontrastregel für diese Ansicht nicht ausgeführt.

Apps, die mit XML geschrieben wurden und die Hinweistextfunktion verwenden, können falsche Positive mit der EditTextName -Regel erhalten. Hinweistext wurde erst in Android 8 (SDK 26) eingeführt. Die Verwendung dieses Elements in Ihrer XML-App weist dem Text-Eingabefeld den Wert des Hinweistextes zu. Neuere Versionen von Android sind besser darauf vorbereitet, dieses Erlebnis barrierefrei zu gestalten.

Um dieses Problem zu überwinden, ist unsere erste Empfehlung, Ihre Tests auf neueren Versionen von Android durchzuführen. Wenn es jedoch wichtig ist, dass die App auf älteren Android-Versionen barrierefrei ist, sollten Sie möglicherweise die Verwendung der hintText -Funktion vermeiden, da diese nicht offiziell unterstützt wird.

Möglicherweise sehen Sie Ergebnisse für Ansichten, die hinter anderen Ansichten auf dem Bildschirm verborgen sind. Diese verborgenen Ansichten sind für assistive Technologien nicht verfügbar, aber Axe DevTools Mobile meldet sie dennoch als Probleme.

Wir arbeiten an einer Lösung für dieses komplexe Problem. In der Zwischenzeit, wenn TalkBack diese Ansichten nicht erreichen kann, können Sie die entsprechenden Probleme ignorieren. Sie erfordern keine Korrektur, um Barrierefreiheit zu gewährleisten.

Die ML Kit Texterkennung ist in vielen der Axe DevTools Mobile-Regeln erforderlich, um die Genauigkeit der Ergebnisse sicherzustellen. Die ML Kit-Bibliothek sollte automatisch importiert werden, wenn Sie auf Axe DevTools Mobile in Ihren automatisierten Espresso- oder UIAutomator-Tests verweisen. In einigen Fällen jedoch erfolgt der automatische Import nicht und Sie sehen die folgende Fehlermeldung im Logcat:

Um dieses Problem zu überwinden, sollten Sie die ML Kit-Bibliothek manuell in Ihr Projekt importieren. In der build.gradle -Datei Ihrer Anwendung fügen Sie Folgendes unter Abhängigkeiten hinzu:

Die Touch Target Spacing-Regel wird derzeit nicht auf Slider-Komponenten ausgeführt, die in Jetpack Compose geschrieben wurden. Im Moment kann keine Maßnahme ergriffen werden. Eine Lösung wird jedoch bald verfügbar sein!

Auf Android API 30 gibt es einen Berechtigungsfehler an einem der Orte, an denen wir versuchen, Ergebnisse lokal zu speichern. Das Ergebnis wird trotzdem als JSON-Datei gespeichert, obwohl dieser Fehler angezeigt wird. Der Fehler kann unterdrückt werden, indem Sie den Code im folgenden Block auskommentieren:
def clearDirectoryTask = task('clearDirectoryTask', type: Exec, group: 'reporting') {
executable "${android.getAdbExecutable().toString()}"
args 'shell', 'rm', '-r', '/storage/emulated/0/Documents/AxeTestCases'
// finalizedBy {
// fetchAndroidFolderAxeReportsTask
// }
}

Bitte beachten Sie, dass dieser Code nur für API 30 auskommentiert werden sollte, da er bei anderen API-Stufen Probleme beim lokalen Speichern verursacht.

In einigen Hybrid- und plattformübergreifenden Apps können wir unerwartete Ergebnisse zurückgeben, wenn Elemente in einer Bildlaufansicht teilweise außerhalb des Bildschirms sind. Um ein Element auf Barrierefreiheit zu testen, stellen Sie sicher, dass es vollständig auf dem Bildschirm ist, bevor Sie den Scan durchführen.

Mit API 31 (Android 12) wurde die Möglichkeit eingeführt, nicht-systemeigene Overlays auszublenden. Um die Axe Analyzer-App zu nutzen, stellen Sie bitte sicher, dass diese Einstellung nicht aktiviert ist. Wenn Sie diese Funktion aus Sicherheitsgründen verwenden, empfehlen wir, sie für interne Test-Builds deaktiviert zu lassen, wo Sie Testdaten sicher nutzen und auf diese Weise Sicherheitsbedenken eliminieren können. Note: this setting does not affect Google's accessibility scanner app as it's considered a system overlay.

Um die Axe Accessibility Analyzer-App zu nutzen, aktualisieren Sie alle Aufrufe der Methode setHideOverlayWindows(true) auf den betroffenen Aktivitätsfenstern. setHideOverlayWindows(false) auf den betroffenen Aktivitätsfenstern.

Um die volle Funktionalität von Axe DevTools für Mobile freizuschalten, stellen Sie sicher, dass Screenshots aktiviert sind. Wir empfehlen, Screenshots in einer Debug- oder Testversion Ihrer App zu aktivieren, die Mock-Daten verwendet, um Sicherheitsbedenken zu vermeiden. Lesen Sie unser Handbuch zum Aktivieren von Screenshots in Android-Apps.

Wenn Sie Ihr Build minimieren, sehen Sie einen Absturz mit einem Fehlerprotokoll, das meldet, dass ein Adapter nicht gefunden werden konnte, wenn versucht wird, sich in die Axe DevTools-Bibliothek einzuloggen. Deaktivieren Sie die Minimierung für Ihre Debug-Builds, die Axe DevTools implementieren. (#729)

Ein Build mit aktiviertem r8 kann versuchen, die axeDevTools-Bibliothek zu minimieren, was zu einem ähnlichen Fehler führt:
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)
Um diesen Fehler zu beheben, fügen Sie die folgende Zeile zu Ihrer ProGuard-Datei hinzu, um axeDevTools-Klassen zu behalten:
keep class com.deque.** { *; }

Die Compose-APIs sind veraltet, bitte verwenden Sie die layout-agnostischen APIs , um weiterhin Updates zu erhalten. Wenn Sie weiterhin die Compose-APIs verwenden und auf einen Fehler stoßen, der etwa so lautet: `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` oder `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, lesen Sie bitte die Compose setTestTag API.

Wenn Sie auf diese Nachricht stoßen, könnten einige Regel-Ergebnisse nicht wie erwartet zurückkehren, wenn diese Regel künstliche Intelligenz nutzt. Betroffene Regeln umfassen Farbkontrast, fokussierbaren Text und verschachtelten Elementnamen. (#841)

Aufgrund von Einschränkungen der MAUI-App-Architektur im Android-Ökosystem wird die Bearbeiten von Textnamenregel im Dashboard als Überprüfung erforderlich angezeigt, wenn ein Fehler für SDK-Version 5.5.0 und höher vermutet wird. Bitte bestätigen Sie das korrekte Verhalten manuell in diesem Fall.

Wenn Sie benutzerdefinierte Dialoge oder Modale implementieren, die die nativen Steuerelemente nicht erweitern, können Ergebnisse für Ansichten hinter dem Modal angezeigt werden. In diesem Fall empfehlen wir, unser Tool nicht gegen diese benutzerdefinierten Modale oder Dialoge auszuführen, sondern sie stattdessen manuell zu überprüfen, um sicherzustellen, dass sie mit unterstützender Technologie wie gewünscht funktionieren.

Wenn der Screenshot auf der Scan-Detail-Seite fehlt, kann es sein, dass Ihre App das Aufnehmen von Screenshots verhindert. Oft geschieht dies aus Sicherheitsgründen in Ihrer Produktionsanwendung. Erwägen Sie, diese Anforderung für Ihren Test-Build zu entfernen, um die volle Funktionalität im Axe DevTools Mobile Dashboard zu ermöglichen.

• Android - FLAG_SECURE

Einige Android-Scan-Namen, die standardmäßig dem Bildschirmtitel entsprechen, werden als vollständiger Klassenname einschließlich des Paketidentifikators angezeigt. In einer zukünftigen Version wird dieses Problem behoben, sodass der Bildschirmtitel in einen besser lesbaren Namen formatiert wird. Als Zwischenlösung können Sie den Scan-Namen aus dem Dashboard oder den Frameworks festlegen. (#1643)