Axe DevTools Mobile Versionshinweise vom 26. November 2025

Apples Barrierefreiheits-APIs können Webinhalte innerhalb von WKWebView fälschlicherweise als „isVisible“ berichten, selbst wenn die Webansicht von nativen Überlagerungen (wie modalen Ansichten, Warnungen oder anderen nativen UI-Elementen) verdeckt ist. Dies geschieht, weil das Barrierefreiheitsystem überprüft, ob der WKWebView-Container selbst sichtbar ist, anstatt ob seine Webinhalte tatsächlich unverdeckt und für den Benutzer wahrnehmbar sind.

iOS 26 enthält einen Barrierefreiheitsfehler, bei dem die Standard-„Stepper“-Tasten nicht „gedimmt“ von Assistive Technology ansagen, um anzuzeigen, dass sie nicht aktiviert sind. Infolgedessen sehen die iOS-Regeln diese Tasten auch dann als aktiviert an, wenn sie es nicht sind. Ein Fehlerbericht wurde an Apple eingereicht, aber bis dies behoben ist, können die folgenden Regeln Ergebnisse von deaktivierten Stepper-Tasten melden: AssociatedText, InaccessibleAction, und ColorContrast.

Bis Apple diesen Fehler behebt, wird empfohlen, die [Regeln zu ignorieren](ios-ignore-rule). Die Standard-Stepper-Tasten 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.

Eine Konfigurationseinstellung im iOS Analyzer 1.4.7 verhindert das Durchführen von Scans und gibt die Meldung „Test fehlgeschlagen“ zurück. Um Scans auf einem physischen Gerät durchzuführen, aktualisieren Sie auf das neueste iOS Analyzer Projekt.

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

Das Scannen einiger Anwendungen mit dieser Version des Analyzers und SDKs führte zu einem "Could not Serialize AxeResult" Fehler. 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 falsche Positive mit LabelInName und LabelAtFront aufgrund einer falsch gefundenen associatedText-Eigenschaft melden (#1622)

Es gibt ein Problem, das den iPhone 15 Pro-Simulator betrifft und die Durchführung der Supports Dynamic Type-Regel verhindert. Wenn Sie für die Supports Dynamic Type-Regel angemeldet sind, können Sie diese nicht mit einem iPhone 15 Pro-Simulator testen. Ein Fehler wurde bei Apple gemeldet.

Während wir nach einer Verbesserung unserer Regeln suchten, stellten wir fest, dass in XCTest verschachtelte Steuerelemente nicht im Accessibility-Tree zurückgegeben werden. Ein Fehler 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 von Apple verwenden, um die Fokussierbarkeit zu überprüfen, können ungenau sein, wenn ein accessibilityIdentifier auf das Bild gesetzt wird. Aufgrund dieses unerwarteten Verhaltens werden Ergebnisse für ImageView-Name-Probleme in UIKit-Apps als „Überprüfung erforderlich“ gemeldet. Ein Fehlerbericht wurde bei Apple eingereicht. (#1633)

Wir arbeiten aktiv an Behebungen für die folgenden Fehlalarme und werden diese Liste aktualisieren, sobald Korrekturen verfügbar sind.

In Scroll View
Kann Probleme für Text innerhalb von Banner-verhaltenden Elementen melden. Um diese Elemente für Personen, die größere Texte benötigen, zugänglich zu machen, verwenden Sie UILargeContentViewer. (#622)

v2.11.0 Image View Name & Active Control Name
Wenn eine UIImageView ein accessibilityIdentifier gesetzt hat, aber nicht von VoiceOver fokussiert wird und sich fokussierbare Steuerelemente darin befinden, kann ActiveControlName einen Fehlalarm auf der UIImageView melden. Das Entfernen des accessibilityIdentifier behebt das Problem. Ein Fehler wurde bei Apple gemeldet. (#1633)

Label In Name and Label At Front
Diese beiden Regeln suchen nach dem sichtbaren Etikett eines Steuerelements unter nahegelegenen Elementen, um den Regelstatus zu bestimmen. In einigen Ansichtshierarchien 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 die Benutzer Ihrer Anwendung sichtbar ist. In Fällen, in denen der Text einer Ansicht die gleiche Farbe wie der Hintergrund hat, kann unser maschinelles Lern-Algorithmus nicht erkennen, ob Text vorhanden ist, sodass die Farbkontrastregel in dieser Ansicht nicht ausgeführt wird.

Apps, die mit XML geschrieben sind und die Hinweistexteigenschaft nutzen, können falsche Positive mit der EditTextName -Regel sehen. Hinweistexte wurden erst mit Android 8 (SDK 26) eingeführt. Wenn Sie dieses Element in Ihrer XML-App verwenden, wird der Hinweistext dem Wert des Texteingabefelds zugewiesen. Neuere Versionen von Android sind besser darauf vorbereitet, dieses Erlebnis zugänglich zu machen.

Um dieses Problem zu umgehen, empfehlen wir zuerst, Ihre Tests auf neueren Versionen von Android durchzuführen. Wenn es jedoch wichtig ist, dass die App auf älteren Android-Versionen zugänglich ist, sollten Sie in Betracht ziehen, die Nutzung des hintText -Features zu vermeiden, da es offiziell nicht unterstützt wird.

Möglicherweise sehen Sie Ergebnisse für Ansichten, die hinter anderen Ansichten auf dem Bildschirm versteckt sind. Diese versteckten Ansichten stehen assistiver Technologie nicht zur Verfügung, 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 sicherzustellen.

Die ML Kit Texterkennung ist in vielen Axe DevTools Mobile-Regeln erforderlich, um die Genauigkeit der Ergebnisse sicherzustellen. Die ML Kit Bibliothek sollte automatisch importiert werden, wenn auf Axe DevTools Mobile in Ihren automatisierten Espresso- oder UIAutomator-Tests verwiesen wird. In einigen Fällen erfolgt der automatische Import jedoch 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. Fügen Sie in der build.gradle -Datei Ihrer Anwendung das Folgende unter Abhängigkeiten hinzu:

Die Touch-Zielabstandsregel wird derzeit bei keinem Schieberegler, der in Jetpack Compose geschrieben wurde, ausgeführt. Derzeit kann keine Maßnahme ergriffen werden. Eine Lösung kommt jedoch bald!

Auf Android API 30 besteht bei einem der Orte, an dem wir versuchen, Ergebnisse lokal zu speichern, ein Berechtigungsfehler. Das Ergebnis wird trotz dieses angezeigten Fehlers weiterhin als JSON-Datei gespeichert. Der Fehler kann unterdrückt werden, indem der folgende Codeblock auskommentiert wird:
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 Probleme beim lokalen Speichern für andere API-Ebenen verursachen würde.

In einigen Hybrid- und plattformübergreifenden Apps können wir unerwartete Ergebnisse zurückgeben, wenn Elemente in einer Scroll-View teilweise außerhalb des Bildschirms sind. Um ein Element auf Zugänglichkeit 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 Fähigkeit eingeführt, nicht-systemische Overlays auszublenden. Um die Axe Analyzer-App zu nutzen, stellen Sie bitte sicher, dass diese Einstellung nicht aktiviert ist. Wenn Sie sich entschieden haben, diese Funktion wegen ihrer Sicherheitsverbesserungen zu nutzen, empfehlen wir, sie in internen Testversionen deaktiviert zu lassen, wo Sie sicher mit Testdaten arbeiten können, um so Sicherheitsbedenken auszuschließen. 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 Mobilgeräte freizuschalten, stellen Sie sicher, dass Screenshots aktiviert sind. Wir empfehlen, Screenshots in einer Debug- oder Testversion Ihrer App zu aktivieren, die mit Mock-Daten verwendet wird, um Sicherheitsbedenken zu vermeiden. Sehen Sie sich unseren Leitfaden für die Aktivierung von Screenshots in Android-Apps an.

Wenn Sie Ihren Build minifizieren, tritt ein Absturz mit einem Fehlerprotokoll auf, das meldet, dass ein Adapter nicht gefunden wurde, wenn versucht wird, sich bei der Axe DevTools-Bibliothek anzumelden. Deaktivieren Sie die Minifizierung für Ihre Debug-Builds mit implementierten Axe DevTools. (#729)

Ein Build mit aktiviertem r8 kann versuchen, die axeDevTools-Bibliothek zu minifizieren, was zu einem ähnlichen Fehler führen kann:
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 die axeDevTools-Klassen beizubehalten:
keep class com.deque.** { *; }

Die Compose-APIs sind veraltet, bitte verwenden Sie die layoutsagnostischen APIs , um weiterhin Updates zu erhalten. Wenn Sie die Compose-APIs weiter verwenden und auf einen Fehler stoßen, der etwa so lautet: `Genau '1' Knoten erwartet aber '2' Knoten gefunden, die passen: (isRoot)` oder `Keine Ansicht initialisiert, haben Sie AxeDevToolsCompose.setComposeTestRule() aufgerufen?`, lesen Sie bitte Compose setTestTag API.

Wenn Sie diese Nachricht erhalten, könnten einige Regelresultate nicht wie erwartet zurückgegeben werden, wenn diese Regel künstliche Intelligenz nutzt. Betroffene Regeln sind Farbkontrast, Fokussierbarer Text und Verschachtelte Elementnamen. (#841)

Aufgrund von Einschränkungen der MAUI-App-Architektur im Android-Ökosystem wird die Regel für den Edit Text Name 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 in diesem Fall das korrekte Verhalten manuell.

Wenn Sie benutzerdefinierte Dialoge oder Modale implementieren, die nicht die nativen Steuerelemente 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 und stattdessen manuell zu prüfen, ob sie mit unterstützender Technologie wie gewünscht funktionieren.

Wenn der Screenshot auf der Scan-Detailseite fehlt, verhindert Ihre App möglicherweise, dass Screenshots erstellt werden. Oft ist dies aus Sicherheitsgründen in Ihrer Produktionsanwendung der Fall. 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-Scannamen, die standardmäßig auf den Bildschirmtitel gesetzt sind, werden als vollständiger Klassenname einschließlich der Bundle-ID angezeigt. In einer zukünftigen Version wird dies behoben, sodass der Bildschirmtitel in einen besser lesbaren Namen formatiert wird. Als Workaround können Sie den Scannamen vom Dashboard oder aus den Frameworks festlegen. (#1643)