Axe DevTools Mobile Versionshinweise vom 6. November 2025

Apples Barrierefreiheits-APIs könnten Webinhalte innerhalb von WKWebView fälschlicherweise als „isVisible“ melden, selbst wenn die Web-View durch native Overlays (wie Modalansichten, Warnungen oder andere native UI-Elemente) abgedeckt ist. Dies geschieht, weil das Barrierefreiheitssystem prüft, ob der WKWebView-Container selbst sichtbar ist und nicht, ob seine Webinhalte tatsächlich ungehindert und für den Benutzer wahrnehmbar sind.

iOS 26 enthält einen Barrierefreiheits-Bug, bei dem die Standard-Schritttaster von unterstützender Technologie nicht als „gedimmt“ angekündigt werden, um anzuzeigen, dass sie nicht aktiviert sind. Infolgedessen sehen auch die iOS-Regeln diese Tasten als aktiviert an, selbst wenn sie es nicht sind. Ein Fehlerbericht wurde bei Apple eingereicht, aber bis dieser behoben ist, können die folgenden Regeln Ergebnisse bei deaktivierten Schritttastern melden: AssociatedText, InaccessibleAction, und ColorContrast.

Solange Apple diesen Fehler nicht behebt, besteht die Lösung darin, [die Regeln zu ignorieren](ios-ignore-rule). Die Standard-Schritttaster haben die Bezeichner „Decrement“ und „Increment“ und können bei Bedarf anhand dieser 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.

Eine Konfigurationseinstellung im iOS Analyzer 1.4.7 verhindert, dass Scans durchgeführt werden, und gibt die Meldung „Test failed“ zurück. Um Scans auf einem physischen Gerät durchzuführen, aktualisieren Sie auf das neueste iOS Analyzer-Projekt.

Die Funktionalität zum Testen einer Anwendung anhand der Bundle-ID war in Version 2.8.1 fehlerhaft, was zu einem Fehler mit dem Titel "No target application path specified via test configuration: ..."führte. Um den Fehler zu beheben, aktualisieren Sie auf Version 2.8.2 oder die neueste Version. Aktualisieren Sie auf das neueste innerhalb des iOS Analyzer-Projekts.

Beim Scannen einiger Anwendungen mit dieser Version des Analyzers und SDKs trat ein "Could not Serialize AxeResult" Fehler auf. Aktualisieren Sie auf die neueste Version, um den Fehler zu beheben. Aktualisieren Sie auf das neueste iOS Analyzer-Projekt.Aktualisieren Sie auf das neueste iOS SDK.

Einige Bildschirme können aufgrund einer fehlerhaften gefundenen Eigenschaft associatedText (#1622) Fehlalarme mit LabelInName und LabelAtFront melden

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 Fehler wurde bei Apple eingereicht.

Bei der Betrachtung einer Verbesserung unserer Regeln stellten wir fest, dass in XCTest verschachtelte Steuerungen im Barrierefreiheitsbaum nicht zurückgegeben werden. Ein Fehler wurde bei Apple eingereicht. (#1110)

In UIKit-Apps ist ein Bild ohne ein accessibilityLabel standardmäßig nicht mit unterstützender Technologie fokussierbar.
Die Eigenschaften, die wir verwenden, um die Fokussierbarkeit von Apple zu überprüfen, können ungenau sein, wenn ein accessibilityIdentifier auf das Bild festgelegt ist. Aufgrund dieses unerwarteten Verhaltens werden die Ergebnisse für Bildansichtsnamen-Probleme in UIKit-Apps als „Überprüfung benötigt“ gemeldet. Ein Fehlerbericht wurde bei Apple eingereicht. (#1633)

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

In Scroll View
Möglicherweise werden Probleme für Text in Banner-verhaltenden Elementen gemeldet. 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 festgelegt hat, aber nicht durch VoiceOver fokussierbar ist, und es fokussierbare Steuerungen enthält, die in ihm verschachtelt sind, kann ActiveControlName einen Fehlalarm beim UIImageView melden. Das Entfernen des accessibilityIdentifier behebt das Problem. Ein Fehler wurde bei Apple eingereicht. (#1633)

Label In Name and Label At Front
Diese beiden Regeln suchen nach dem sichtbaren Label einer Steuerung unter den nahen Elementen, um den Regelstatus zu bestimmen. In einigen Ansichtshierarchien kann der falsche nahe 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 die Benutzer Ihrer Anwendung sichtbar ist. In Fällen, in denen der im View enthaltene Text die gleiche Farbe wie der Hintergrund hat, kann unser Machine-Learning-Algorithmus nicht erkennen, ob ein Text vorhanden ist, sodass die Farbkontrastregel nicht auf diesem View ausgeführt wird.

Apps, die mit XML geschrieben sind und die Funktion des Hinweistextes nutzen, könnten auf falsche positive Ergebnisse bei der EditTextName Regel stoßen. Hinweistext wurde erst mit Android 8 (SDK 26) eingeführt. Die Verwendung dieses Elements in Ihrer XML-App ordnet den Hinweistext dem Wert des Texteingabefeldes zu. Neuere Versionen von Android sind besser darauf ausgelegt, diese Erfahrung zugänglich zu machen.

Um dieses Problem zu überwinden, empfehlen wir als Erstes, Ihre Tests auf neueren Versionen von Android auszuführen. Ist es jedoch wichtig, dass die App auch auf älteren Android-Versionen zugänglich ist, könnten Sie in Erwägung ziehen, von der Nutzung der hintText Funktion abzusehen, da sie nicht offiziell unterstützt wird.

Es können Ergebnisse für Ansichten angezeigt werden, die auf dem Bildschirm hinter anderen Ansichten verborgen sind. Diese versteckten Ansichten sind für unterstützende 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 auf diese Ansichten nicht zugreifen kann, können Sie die entsprechenden Probleme ignorieren. Sie erfordern keine Behebung, um die Barrierefreiheit sicherzustellen.

ML Kit Texterkennung wird bei vielen der Axe DevTools Mobile-Regeln benötigt, um die Genauigkeit der Ergebnisse sicherzustellen. Die ML Kit-Bibliothek sollte automatisch importiert werden, wenn Sie Axe DevTools Mobile in Ihren automatisierten Espresso- oder UIAutomator-Tests referenzieren. In einigen Fällen jedoch erfolgt der automatische Import nicht, und Sie sehen den folgenden Fehler im Logcat:

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

Die Touch-Target-Abstandsregel wird derzeit nicht für Slider-Komponenten ausgeführt, die in Jetpack Compose geschrieben wurden. Derzeit können keine Maßnahmen ergriffen werden. Es wird jedoch bald eine Lösung geben!

Auf Android API 30 gibt es bei einer der Speicherorte, an denen wir versuchen, Ergebnisse lokal zu speichern, einen Berechtigungsfehler. Das Ergebnis wird dennoch 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 es ansonsten zu Problemen beim lokalen Speichern auf anderen API-Stufen kommen kann.

In einigen Hybrid- und plattformübergreifenden Apps können unerwartete Ergebnisse zurückgegeben werden, wenn Elemente in einer Scroll-Ansicht teilweise vom Bildschirm verschwinden. 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 Überlagerungen auszublenden. Um die Axe Analyzer-App zu nutzen, stellen Sie bitte sicher, dass diese Einstellung nicht aktiviert ist. Wenn Sie diese Funktion aufgrund ihrer Sicherheitsverbesserungen nutzen, empfehlen wir, sie für interne Testbuilds ausgeschaltet zu lassen, wo Sie sicher mit Testdaten arbeiten können, um Sicherheitsbedenken auszuräumen. 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) zu setHideOverlayWindows(false) für die betroffenen Aktivitätsfenster.

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 mit fiktiven Daten arbeitet, um Sicherheitsbedenken zu vermeiden. Sehen Sie sich unseren Leitfaden an zum Aktivieren von Screenshots in Android-Apps.

Wenn Sie Ihr Build verkleinern, wird ein Absturz mit einem Fehlerprotokoll angezeigt, das meldet, dass ein Adapter beim Versuch, sich bei der Axe DevTools-Bibliothek anzumelden, nicht gefunden werden konnte. Deaktivieren Sie die Verkleinerung für Ihre Debug-Builds mit Axe DevTools implementiert. (#729)

Ein Build mit aktiviertem r8 könnte versuchen, die axeDevTools-Bibliothek zu verkleinern, was zu einem Fehler ähnlich führt wie:
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 in Ihre ProGuard-Datei ein, um axeDevTools-Klassen zu behalten:
keep class com.deque.** { *; }

Die Compose-APIs sind veraltet, bitte verwenden Sie die layouts-agnostischen APIs , um weiterhin Updates zu erhalten. Wenn Sie weiterhin die Compose-APIs verwenden und auf einen Fehler stoßen wie „Genau '1' Knoten erwartet, aber '2' Knoten gefunden, die erfüllen: (isRoot)“ oder „Keine Ansicht initialisiert, haben Sie AxeDevToolsCompose.setComposeTestRule() aufgerufen?“, beziehen Sie sich bitte auf die Compose setTestTag API.

Wenn Sie diese Nachricht sehen, könnten einige Regel-Ergebnisse nicht wie erwartet zurückgegeben werden, wenn diese Regel künstliche Intelligenz nutzt. Betroffene Regeln umfassen Farbkontrast, fokussierbaren Text und Namen verschachtelter Elemente. (#841)

Aufgrund von Einschränkungen der MAUI-App-Architektur im Android-Ökosystem wird die Regel zur Bearbeitung der Textnamen 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 in diesem Fall manuell.

Wenn Sie benutzerdefinierte Dialoge oder Modale implementieren, die nicht die nativen Steuerelemente erweitern, könnten Sie Ergebnisse für Ansichten hinter dem Modal erhalten. In diesem Fall empfehlen wir, unser Werkzeug nicht gegen diese benutzerdefinierten Modale oder Dialoge zu verwenden und stattdessen manuell zu prüfen, ob sie wie gewünscht mit unterstützender Technologie funktionieren.

Wenn der Screenshot auf der Scan-Detailseite fehlt, verhindert Ihre App möglicherweise das Erstellen von Screenshots. Oftmals geschieht dies aus Sicherheitsgründen in Ihrer Produktionsanwendung. Erwägen Sie, diese Anforderung für Ihre Testversion 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 auf den Bildschirmtitel gesetzt sind, werden als vollständiger Klassenname inklusive des Bundle-Identifiers angezeigt. In einer zukünftigen Version wird dieses Problem behoben, sodass der Bildschirmtitel in einen besser lesbaren Namen formatiert wird. Als Lösung können Sie den Scan-Namen vom Dashboard oder Frameworks aus festlegen. (#1643)