Axe DevTools Mobile Versionshinweise zum 12. Februar 2025

Die Funktionalität beim Testen einer Anwendung nach Bundle-Identifikator wurde in Version 2.8.1 unterbrochen, was zu einem Fehler mit dem Titel „Kein Zielanwendungspfad über die Testkonfiguration angegeben: ...“ führte. Aktualisieren Sie auf Version 2.8.2 oder die neueste Version, um den Fehler zu beheben. Auf die neueste Version im iOS Analyzer-Projekt aktualisieren.

Das Scannen einiger Anwendungen mit dieser Version des Analyzers und SDK würde zu einem Fehler "Could not Serialize AxeResult" führen. Aktualisieren Sie auf die neueste Version, um den Fehler zu beheben. Auf das neueste iOS Analyzer-Projekt aktualisieren.Auf das neueste iOS SDK aktualisieren.

Einige Bildschirme zeigen möglicherweise false positives mit LabelInName und LabelAtFront aufgrund einer falschen associatedText-Eigenschaft (#1622)

Es gibt ein Problem, das den iPhone 15 Pro Simulator betrifft und verhindert, dass die Regel "Unterstützte dynamische Typen" läuft. Wenn Sie in die Regel "Unterstützte dynamische Typen" eingebunden sind, können Sie diese nicht mit einem iPhone 15 Pro-Simulator testen. Ein Fehlerbericht wurde bei Apple eingereicht.

Bei der Betrachtung einer Verbesserung unserer Regeln haben wir entdeckt, dass in XCTest verschachtelte Steuerelemente nicht im Barrierefreiheitsbaum zurückgegeben werden. Ein Fehlerbericht wurde bei Apple eingereicht. (#1110)

In UIKit-Apps ist ein Bild ohne ein `accessibilityLabel` standardmäßig nicht mit assistiven Technologien fokussierbar.
Die Eigenschaften, die wir zur Überprüfung der Fokussierbarkeit von Apple verwenden, können ungenau sein, wenn eine `accessibilityIdentifier` auf dem Bild gesetzt ist. Aufgrund dieses unerwarteten Verhaltens werden Ergebnisse für Probleme mit dem ImageView-Namen in UIKit-Apps als „Muss überprüft werden“ ausgewiesen. Ein Fehlerbericht wurde bei Apple eingereicht. (#1633)

Wir arbeiten aktiv an Korrekturen für die folgenden falsch-positiven Ergebnisse und werden diese Liste aktualisieren, sobald die Korrekturen verfügbar sind.

In Scroll View
Kann Probleme für Text innerhalb von Banner-Verhaltenselementen 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 ein UIImageView eine `accessibilityIdentifier` gesetzt hat, aber nicht von VoiceOver fokussierbar ist und es fokussierbare Steuerungen innerhalb davon gibt, kann ActiveControlName ein False Positive auf dem UIImageView melden. Das Entfernen der `accessibilityIdentifier` behebt das Problem. Ein Fehlerbericht wurde bei Apple eingereicht. (#1633)

Label In Name and Label At Front
Diese beiden Regeln suchen nach einem sichtbaren Etikett einer Steuerung unter benachbarten Elementen, um den Regelstatus zu bestimmen. In einigen Ansichtshierarchien kann der falsche nahegelegene Text erkannt werden, was zu einem Fehlschlagen dieser Regeln führt. (#1622)

Die Touch Target Abstand-Regel wird derzeit nicht für Schieberegler-Komponenten ausgeführt, die in Jetpack Compose geschrieben wurden. Derzeit kann nichts unternommen werden. Eine Korrektur 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 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
//    }
}

In einigen Hybrid- und plattformübergreifenden Apps können unerwartete Ergebnisse auftreten, wenn Elemente in einer Scroll-Ansicht teilweise außerhalb des Bildschirms liegen. 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, nichtsystemeigene Overlays auszublenden. Um die Axe Analyzer-App zu nutzen, stellen Sie sicher, dass diese Einstellung nicht aktiviert ist. Wenn Sie sich entschieden haben, diese Funktion aufgrund ihrer Sicherheitsverbesserungen zu nutzen, empfehlen wir, sie für interne Testversionen deaktiviert zu lassen, wo Sie sicher Testdaten verwenden und Sicherheitsbedenken auf diese Weise eliminieren 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) zu setHideOverlayWindows(false) in 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 zum Aktivieren von Screenshots in Android-Apps an.

Wenn Sie Ihren Build minimieren, tritt ein Absturz mit einem Fehlerprotokoll auf, in dem berichtet wird, 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 Fehler führt, ähnlich zu:

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)
    

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 wie „Genau '1' Knoten erwartet, aber '2' Knoten gefunden, die folgende Bedingung erfüllen: (isRoot)“ oder „Keine Ansicht initialisiert, haben Sie AxeDevToolsCompose.setComposeTestRule() aufgerufen?“, verweisen Sie bitte auf Compose setTestTag API.

Wenn Sie diese Meldung erhalten, werden einige Regel-Ergebnisse möglicherweise nicht wie erwartet zurückgegeben, wenn diese Regel künstliche Intelligenz verwendet. Betroffene Regeln umfassen Farbkontrast, Fokussierbarer Text und Verschachtelter Elementname. (#841)

Aufgrund von Einschränkungen der MAUI-App-Architektur im Android-Ökosystem wird die Regel für Edit Text Name im Dashboard als "Needs Review" 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 Modals implementieren, die nicht die nativen Steuerungen erweitern, können Sie Ergebnisse für Ansichten hinter dem Modal erhalten. In diesem Fall empfehlen wir, unser Tool nicht gegen diese benutzerdefinierten Modale oder Dialoge auszuführen, sondern sie manuell zu überprüfen, um sicherzustellen, dass sie mit unterstützender Technologie wie gewünscht funktionieren.

Wenn der Screenshot auf der Scan-Detailseite fehlt, kann Ihre App verhindern, dass Screenshots gemacht werden. Oft ist dies aus Sicherheitsgründen in Ihrer Produktionsanwendung der Fall. Überlegen 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, erscheinen als vollständiger Klassenname inklusive Bundle-Identifier. In einem zukünftigen Release wird dies behoben, sodass der Bildschirmtitel in einen besser lesbaren Namen formatiert wird. Als Workaround können Sie den Scan-Namen vom Dashboard oder aus den Frameworks festlegen. (#1643)