Axe DevTools Mobile Versionshinweise zur Veröffentlichung am 14. August 2025

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 Ausführen von Scans und gibt die Meldung „Test fehlgeschlagen“ zurück. Um Scans auf einem physischen Gerät auszuführen, aktualisieren Sie auf das neueste iOS Analyzer Projekt.

Die Funktionalität zum Testen einer Anwendung nach Bundle-Identifier war in der Version 2.8.1 fehlerhaft, was zu einem Fehler mit dem Titel führte "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 das neueste 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 Fehlalarme mit LabelInName und LabelAtFront melden, da eine falsche associatedText-Eigenschaft gefunden wurde (#1622)

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

Bei der Überprüfung unserer Regeln stellten wir fest, dass in XCTest verschachtelte Steuerelemente nicht im Accessibility-Tree zurückgegeben werden. Ein Fehlerbericht wurde bei Apple eingereicht. (#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 fehlerhaft sein, wenn ein accessibilityIdentifier auf das Bild gesetzt ist. Aufgrund dieses unerwarteten Verhaltens werden Ergebnisse für ImageView-Namensprobleme in UIKit-Apps als zu überprüfend gemeldet. Ein Fehlerbericht wurde bei Apple eingereicht. (#1633)

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

In Scroll View
Kann Probleme für Text innerhalb von bannerähnlichen Elementen melden. Um diese Elemente für Nutzer, die größere Text benötigt, verfügbar zu machen, 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 Steuerelemente enthält, kann ActiveControlName einen Fehlalarm auf dem UIImageView melden. Das Entfernen des accessibilityIdentifier löst das Problem. Ein Fehlerbericht wurde bei Apple eingereicht. (#1633)

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

Unsere Farbkontrast-Regel 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 im View enthaltene Text die gleiche Farbe wie der Hintergrund hat, kann unser maschinelles Lernalgorithmus nicht feststellen, ob Text vorhanden ist, daher wird die Farbkontrast-Regel für diese Ansicht nicht ausgeführt.

Apps, die mit XML geschrieben sind und die Hinweistext-Funktionalität nutzen, könnten Fehlalarme mit der EditTextName Regel sehen. Hinweistext wurde erst mit Android 8 (SDK 26) eingeführt. Die Verwendung dieses Elements in Ihrer XML-App weist den Hinweistext dem Wert des Texteingabefelds zu. Neuere Versionen von Android sind besser in der Lage, dieses Erlebnis zugänglich zu machen.

Um dieses Problem zu umgehen, empfehlen wir zunächst, Ihre Tests auf neueren Android-Versionen durchzuführen. Falls es wichtig ist, dass die App auf älteren Android-Versionen zugänglich ist, sollten Sie die Verwendung von hintText vermeiden, da es nicht offiziell unterstützt wird.

Es können Ergebnisse für Ansichten angezeigt werden, die sich hinter anderen Ansichten auf dem Bildschirm verbergen. Diese versteckten Ansichten sind für unterstützende Technologien nicht verfügbar, jedoch meldet Axe DevTools Mobile 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 Lösung zur Sicherstellung der Barrierefreiheit.

ML Kit Texterkennung ist in vielen der Regeln von Axe DevTools Mobile erforderlich, um die Genauigkeit der Ergebnisse zu gewährleisten. Die ML Kit-Bibliothek sollte automatisch importiert werden, wenn Axe DevTools Mobile in Ihren automatisierten Espresso- oder UIAutomator-Tests referenziert 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. In der build.gradle Datei Ihrer Anwendung fügen Sie Folgendes unter Abhängigkeiten hinzu:

Die Touch-Target-Abstandsregel wird derzeit nicht für Slider-Komponenten, die in Jetpack Compose geschrieben wurden, ausgeführt. Derzeit kann keine Maßnahme ergriffen werden. Eine Lösung ist jedoch in Kürze verfügbar!

Unter Android API 30 hat ein Standort, an dem 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 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-Leveln Probleme beim lokalen Speichern verursachen wird.

In einigen Hybrid- und plattformübergreifenden Apps können wir unerwartete Ergebnisse zurückgeben, wenn Elemente in einer Scroll-Ansicht teilweise außerhalb des Bildschirms liegen. Um ein Element auf Zugänglichkeit 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-systemische Überlagerungen auszublenden. Um die Axe Analyzer-App zu nutzen, stellen Sie bitte sicher, dass diese Einstellung nicht aktiviert ist. Wenn Sie sich entschieden haben, dieses Feature für dessen Sicherheitsvorteile zu nutzen, empfehlen wir, es für interne Testversionen deaktiviert zu lassen, bei denen Sie sicher Testdaten verwenden können und Sicherheitsbedenken auf diese Weise ausschließ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) zu 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. Sehen Sie sich unseren Leitfaden zur Aktivierung von Screenshots in Android-Apps an.

Wenn Sie Ihr Build minimieren, wird ein Absturz mit einem Fehlerprotokoll angezeigt, das meldet, 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, bei denen Axe DevTools implementiert ist. (#729)

Ein Build mit aktiviertem r8 versucht möglicherweise, die axeDevTools-Bibliothek zu minimieren, was zu einem Fehler ähnlich dem folgenden 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 in Ihre ProGuard-Datei ein, um axeDevTools-Klassen beizubehalten:
keep class com.deque.** { *; }

Die Compose-APIs sind veraltet, bitte verwenden Sie die layout-agnostischen APIs , um weiterhin Updates zu erhalten. Wenn Sie die Compose-APIs weiterhin verwenden und auf einen Fehler stoßen, der in etwa lautet: „Erwartet wurde genau '1' Knoten, aber es wurden '2' Knoten gefunden, die dies 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 erhalten, werden einige Regelresultate möglicherweise nicht wie erwartet zurückgegeben, wenn diese Regel künstliche Intelligenz verwendet. Betroffene Regeln sind Farbkontrast, fokussierbarer Text und verschachtelter Elementname. (#841)

Aufgrund von Einschränkungen der MAUI-App-Architektur im Android-Ökosystem wird die Regel für Texteingabenamen im Dashboard als „Überprüfung erforderlich“ angezeigt, wenn ein Fehler bei 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 implementieren, die die nativen Kontrollen 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, sondern diese stattdessen manuell zu überprüfen, um sicherzustellen, dass sie wie gewünscht mit unterstützender Technologie funktionieren.

Wenn der Screenshot auf der Scan-Detailseite fehlt, verhindert Ihre App möglicherweise, dass Screenshots aufgenommen werden können. Häufig geschieht dies aus Sicherheitsgründen in Ihrer Produktionsanwendung. Erwägen Sie, diese Anforderung für Ihr 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 auf den Bildschirmtitel voreingestellt sind, werden als vollständiger Klassenname einschließlich des Paketkennzeichens angezeigt. In einer zukünftigen Version wird dies behoben, sodass der Bildschirmtitel in einen leichter lesbaren Namen formatiert wird. Als Workaround können Sie den Scan-Namen im Dashboard oder in den Frameworks festlegen. (#1643)