Axe DevTools Mobile Versionshinweise vom 19. Dezember 2025

Bei Barrierefreiheitsprüfungen auf kleineren Bildschirmen oder mit kleineren Schriftgrößen kann die Farbkontrastregel Fehlalarme für Farbverlaufs-Hintergründe melden. In solchen Fällen kann es vorkommen, dass die Vordergrundfarbe nicht bestimmt werden kann und stattdessen Hintergrundfarben miteinander verglichen werden, was zu einem Fehler führt.

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

Apples Barrierefreiheits-APIs können Webinhalte innerhalb von WKWebView fälschlicherweise als „isVisible“ melden, selbst wenn die Webansicht von nativen Overlays (wie modalen Ansichten, Benachrichtigungen oder anderen nativen UI-Elementen) überdeckt wird. Dies geschieht, da das Barrierefreiheits-System prüft, ob der WKWebView-Container selbst sichtbar ist und nicht, ob seine Webinhalte tatsächlich unbehindert und wahrnehmbar für den Nutzer sind.

iOS 26 enthält einen Barrierefreiheitsfehler, bei dem die Standard-Schrittmachertasten nicht "abgedunkelt" durch unterstützende Technologie anzeigen, um darauf hinzuweisen, dass sie nicht aktiviert sind. Dadurch erkennen auch die iOS-Regeln diese Tasten als aktiviert, selbst wenn sie es nicht sind. Ein Fehlerbericht wurde bei Apple eingereicht, aber bis dies behoben ist, können die folgenden Regeln Ergebnisse bei deaktivierten Schrittmachertasten melden: AssociatedText, InaccessibleAction, und ColorContrast.

Bis Apple diesen Fehler behebt, besteht die Lösung darin, [die Regeln zu ignorieren](ios-ignore-rule). Die Standard-Schrittmachertasten haben die Bezeichnungen "Decrement" und "Increment" und können bei Bedarf anhand ihrer Bezeichnung 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 aufgrund einer falsch gefundenen associatedText-Eigenschaft (#1622) Falschmeldungen bei LabelInName und LabelAtFront melden

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

Während der Betrachtung einer Verbesserung unserer Regeln haben wir festgestellt, dass in XCTest verschachtelte Bedienelemente nicht im Barrierefreiheitsbaum 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 zur Überprüfung der Fokussierbarkeit von Apple nutzen, können ungenau sein, wenn eine accessibilityIdentifier auf dem Bild gesetzt ist. 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 Korrekturen für die folgenden Falschmeldungen und werden diese Liste aktualisieren, sobald Korrekturen veröffentlich sind.

In Scroll View
Kann Probleme für Text innerhalb von Banner-verhaltenden 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 eine accessibilityIdentifier gesetzt hat, aber nicht von VoiceOver fokussierbar ist und es fokussierbare Steuerelemente in sich hat, kann es vorkommen, dass ActiveControlName ein falsch positives Ergebnis für das UIImageView meldet. Das Entfernen der accessibilityIdentifier löst das Problem. Ein Fehler wurde bei Apple gemeldet. (#1633)

Label In Name and Label At Front
Diese beiden Regeln suchen nach einem sichtbaren Label eines Steuerelements in der Nähe befindlicher Elemente, um den Status der Regel zu bestimmen. In manchen Ansichts-Hierarchien kann ein falscher Text in der Nähe erkannt werden, was zu einem Fehler dieser Regeln führt. (#1622)

Unsere Regel zur Farbkontrasterkennung 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 in einer Ansicht die gleiche Farbe wie der Hintergrund hat, kann unser Algorithmus des maschinellen Lernens nicht erkennen, ob Text vorhanden ist, daher wird die Farbkontrasterkennungs-Regel für diese Ansicht nicht ausgeführt.

Apps, die mit XML geschrieben sind und die Hint-Text-Funktion nutzen, könnten falsch positive Ergebnisse mit der EditTextName Regel sehen. Der Hint-Text wurde erst mit Android 8 (SDK 26) eingeführt. Wenn dieses Element in Ihrer XML-App verwendet wird, wird der Hint-Text dem Wert des Texteingabefelds zugewiesen. Neuere Versionen von Android sind besser ausgestattet, um dieses Erlebnis barrierefrei zu gestalten.

Um dieses Problem zu überwinden, ist unsere erste Empfehlung, Ihre Tests auf neueren Android-Versionen durchzuführen. Wenn es jedoch wichtig ist, dass die App auf früheren Android-Versionen barrierefrei ist, sollten Sie erwägen, auf die Nutzung der hintText Funktion zu verzichten, da sie nicht offiziell unterstützt wird.

Es können Ergebnisse für Ansichten angezeigt werden, die hinter anderen Ansichten auf dem Bildschirm verborgen sind. Diese verborgenen Ansichten sind für unterstützende Technologien nicht verfügbar, werden aber von Axe DevTools Mobile dennoch als Probleme gemeldet.

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. Es ist keine Korrektur erforderlich, um Barrierefreiheit sicherzustellen.

Die ML Kit Texterkennung ist in vielen der Axe DevTools Mobile Regeln erforderlich, um Genauigkeit der Ergebnisse zu gewährleisten. 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 geschieht der automatische Import jedoch nicht und Sie sehen die folgende Fehlermeldung im Logcat:

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

Die Regel für den Touch-Ziel-Abstand läuft derzeit nicht auf Schiebereglern, die in Jetpack Compose geschrieben wurden. Derzeit sind keine Maßnahmen erforderlich. Eine Lösung kommt jedoch bald!

Auf Android API 30 gibt es bei einem der Orte, an denen wir versuchen, Ergebnisse lokal zu speichern, einen Berechtigungsfehler. Das Ergebnis wird trotz dieser Fehlermeldung weiterhin als JSON-Datei gespeichert. Der Fehler kann unterdrückt werden, indem der Code im folgenden Block 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 bei anderen API-Stufen Probleme beim lokalen Speichern verursachen wird.

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

Mit API 31 (Android 12) wurde die Möglichkeit eingeführt, nicht-systemüberlagernde 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 für deren Sicherheitsverbesserungen zu nutzen, empfehlen wir, sie für interne Testversionen, bei denen Sie sicher Testdaten nutzen und Sicherheitsbedenken auf diese Weise ausschließen können, deaktiviert zu lassen. 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) auf den betroffenen Aktivitätsfenstern.

Um die vollständige 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. Sehen Sie sich unseren Leitfaden zum Aktivieren von Screenshots in Android-Apps an.

Wenn Sie Ihren Build minifizieren, sehen Sie einen Absturz mit einer Fehlermeldung, die meldet, dass ein Adapter nicht gefunden werden konnte, 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 könnte versuchen, die axeDevTools-Bibliothek zu minifizieren, was zu einem ähnlichen Fehler 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 Ihrer ProGuard-Datei folgende Zeile 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 der Art `Erwartet genau '1' Knoten, aber '2' Knoten gefunden, die die Bedingung erfüllen: (isRoot)` oder `Kein View initialisiert, haben Sie AxeDevToolsCompose.setComposeTestRule() aufgerufen?` stoßen, beziehen Sie sich bitte auf 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, Fokussierbarer Text und Verschachtelter Elementname. (#841)

Aufgrund von Einschränkungen der MAUI-App-Architektur im Android-Ökosystem wird die Regel zum Edit-Text-Namen 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 manuell das korrekte Verhalten.

Wenn Sie benutzerdefinierte Dialoge oder Modale Fenster implementieren, die nicht auf den nativen Steuerungen basieren, können Sie Ergebnisse von Ansichten hinter dem Modalfenster erhalten. In diesem Fall empfehlen wir, unser Tool nicht gegen diese benutzerdefinierten Modale Fenster oder Dialoge auszuführen und stattdessen manuell zu überprüfen, ob sie wie gewünscht mit unterstützender Technologie funktionieren.

Wenn der Screenshot auf der Seite mit den Scan-Details fehlt, verhindert Ihre App möglicherweise, dass Screenshots aufgenommen werden. Oft 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-Scannamen, die standardmäßig dem Bildschirmtitel entsprechen, werden als vollständiger Klassenname einschließlich der Bundle-ID angezeigt. In einer zukünftigen Version wird dieses Problem behoben, sodass der Bildschirmtitel in einen lesbareren Namen formatiert wird. Als Workaround können Sie den Scannamen über das Dashboard oder die Frameworks festlegen. (#1643)