Axe DevTools Mobile Versionshinweise vom 24. September 2025

iOS 26 enthält einen Barrierefehler, bei dem Standard-Stepper-Schaltflächen von Assistive Technology nicht als „gedimmt“ angekündigt werden, um anzuzeigen, dass sie nicht aktiviert sind. Infolgedessen sehen auch die iOS-Regeln diese Schaltflächen als aktiviert an, selbst wenn sie es nicht sind. Bei Apple wurde ein Fehlerbericht eingereicht, aber bis dies behoben ist, können die folgenden Regeln auf inaktivierte Stepper-Schaltflächen Ergebnisse melden: AssociatedText, InaccessibleActionund ColorContrast.

Bis Apple diesen Fehler behebt, besteht die Lösung darin, [die Regeln zu ignorieren](ios-ignore-rule). Die Standard-Stepper-Schaltflächen haben die Bezeichner „Decrement“ und „Increment“ und können bei Bedarf nach 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 ausgeführt werden, 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 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: ...". Aktualisieren Sie auf 2.8.2 oder die neueste Version, um den Fehler zu beheben. Aktualisieren Sie auf die neueste Version innerhalb des iOS Analyzer-Projekts.

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

Es gibt ein Problem, das den iPhone 15 Pro Simulator betrifft, das verhindert, dass die Regel „Supports Dynamic Type“ ausgeführt wird. Wenn Sie an der Regel „Supports Dynamic Type“ teilnehmen, können Sie sie nicht mit einem iPhone 15 Pro Simulator testen. Bei Apple wurde ein Fehler gemeldet.

Während wir eine Verbesserung unserer Regeln untersuchten, stellten wir fest, dass in XCTest verschachtelte Steuerelemente im Barrierefreiheitsbaum nicht zurückgegeben werden. Bei Apple wurde ein Fehler gemeldet. (#1110)

In UIKit-Apps ist ein Bild ohne ein accessibilityLabel standardmäßig nicht mit unterstützender Technologie fokussierbar.
Die von uns verwendeten Eigenschaften zur Überprüfung der Fokussierbarkeit von Apple können ungenau sein, wenn ein accessibilityIdentifier auf dem Bild festgelegt ist. Aufgrund dieses unerwarteten Verhaltens werden Ergebnisse für ImageView Name-Probleme in UIKit-Apps als „Überprüfung erforderlich“ gemeldet. Bei Apple wurde ein Fehlerbericht eingereicht. (#1633)

Wir arbeiten aktiv an Lösungen für die folgenden falsch positiven Ergebnisse und werden diese Liste aktualisieren, sobald Korrekturen veröffentlicht werden.

In Scroll View
Es können Probleme für Text in Banner-verhaltenden Elementen gemeldet werden. Um diese Elemente denjenigen zugänglich zu machen, die größeren Text benötigen, verwenden Sie UILargeContentViewer. (#622)

v2.11.0 Image View Name & Active Control Name
Wenn ein UIImageView ein accessibilityIdentifier gesetzt hat, jedoch nicht von VoiceOver fokussierbar ist und es fokussierbare Steuerelemente enthält, kann ActiveControlName ein falsches Positiv auf dem UIImageView melden. Das Entfernen des accessibilityIdentifier behebt das Problem. Bei Apple wurde ein Fehler eingereicht. (#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 einigen Ansichts-Hierarchien kann der falsche nahegelegene Text erkannt werden, sodass 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, kann unser maschinelles Lernverfahren nicht erkennen, ob Text vorhanden ist, sodass die Farbkontrastregel auf dieser Ansicht nicht ausgeführt wird.

Apps, die mit XML geschrieben wurden und die Funktionalität für Hinweistexte nutzen, können bei der EditTextName Regel. Der Hilfetext wurde erst mit Android 8 (SDK 26) eingeführt. Wenn Sie dieses Element in Ihrer XML-Anwendung verwenden, wird der Hilfetext dem Wert des Textfelder zugewiesen. Neuere Versionen von Android sind besser geeignet, um diese Erfahrung zugänglich zu machen.

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 älteren Android-Versionen zugänglich ist, sollten Sie die Verwendung der hintText Funktion in Betracht ziehen, da sie nicht offiziell unterstützt wird.

Sie könnten Ergebnisse für Ansichten sehen, die hinter anderen Ansichten auf dem Bildschirm verborgen sind. Diese versteckten Ansichten sind nicht für unterstützende Technologien 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. Es ist keine Lösung erforderlich, um die Barrierefreiheit sicherzustellen.

Die Texterkennung mit ML Kit 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 in Ihren automatisierten Espresso- oder UIAutomator-Tests auf Axe DevTools Mobile verweisen. In einigen Fällen jedoch erfolgt der automatische Import nicht und Sie sehen folgenden Fehler im Logcat:

Um dieses Problem zu lösen, 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-Ziel-Abstand Regel wird derzeit nicht auf Schieberegler-Komponenten ausgeführt, die in Jetpack Compose geschrieben wurden. Derzeit können keine Maßnahmen ergriffen werden. Eine Lösung ist jedoch bald verfügbar!

Auf Android API 30 gibt es einen Berechtigungsfehler an einem der Orte, an denen wir versuchen, Ergebnisse lokal zu speichern. 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 er Probleme beim lokalen Speichern für andere API-Level verursachen wird.

In einigen hybriden und plattformübergreifenden Apps können wir unerwartete Ergebnisse zurückgeben, wenn sich Elemente in einer Bildlaufansicht teilweise außerhalb des Bildschirms befinden. 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 Fähigkeit eingeführt, nicht-systemeigene Overlays auszublenden. Um die Axe Analyzer-App nutzen zu können, stellen Sie bitte sicher, dass diese Einstellung nicht aktiviert ist. Wenn Sie sich entschieden haben, diese Funktion wegen ihrer Sicherheitsverbesserungen zu verwenden, empfehlen wir, sie für interne Test-Builds ausgeschaltet zu lassen, wo Sie sicher Testdaten verwenden und Sicherheitsbedenken auf diese Weise beseitigen 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 nutzt, um Sicherheitsbedenken zu vermeiden. Sehen Sie sich unseren Leitfaden zum Aktivieren von Screenshots in Android-Apps an.

Wenn Sie Ihren Build minimieren, sehen Sie einen Absturz mit einem Fehlerprotokoll, das berichtet, dass ein Adapter nicht gefunden werden konnte, wenn versucht wird, sich bei der Axe DevTools-Bibliothek anzumelden. Deaktivieren Sie die Minimierung für Ihre Debug-Builds mit implementierten Axe DevTools. (#729)

Ein Build mit aktiviertem r8 kann versuchen, die axeDevTools-Bibliothek zu minimieren, 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 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 in etwa lautet: `Es wurde genau '1' Knoten erwartet, aber '2' Knoten gefunden, die die Bedingung erfüllen: (isRoot)` oder `Kein View initialisiert, haben Sie AxeDevToolsCompose.setComposeTestRule() aufgerufen?`, beziehen Sie sich bitte auf Compose setTestTag API.

Wenn Sie diese Meldung sehen, werden einige Regelergebnisse möglicherweise nicht wie erwartet zurückgegeben, wenn diese Regel künstliche Intelligenz nutzt. Betroffene Regeln sind unter anderem Farbkontrast, fokussierbarer Text und verschachtelte Elementnamen. (#841)

Aufgrund von Einschränkungen der MAUI-App-Architektur im Android-Ökosystem wird die Regel Edit Text Name im Dashboard als muss überprüft werden 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 die nativen Steuerelemente nicht erweitern, erhalten Sie möglicherweise Ergebnisse für Ansichten hinter dem Modal. In diesem Fall empfehlen wir, unser Tool nicht gegen diese benutzerdefinierten Modale oder Dialoge auszuführen und stattdessen manuell zu überprüfen, ob sie sich mit unterstützender Technologie wie gewünscht verhalten.

Wenn der Screenshot auf der Scan-Detailseite fehlt, verhindert Ihre App möglicherweise, dass Screenshots erstellt werden. Oft liegt dies aus Sicherheitsgründen in Ihrer Produktionsanwendung vor. Erwägen Sie, diese Anforderung für Ihre Testversion aufzuheben, 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, erscheinen als vollständiger Klassenname einschließlich der Bundle-Kennung. In einer zukünftigen Version wird dies behoben, sodass der Bildschirmtitel in einen besser lesbaren Namen formatiert wird. Als Lösung können Sie den Scannamen über das Dashboard oder die Frameworks festlegen. (#1643)