Axe DevTools Mobile Release Notes vom 16. Januar 2025

Die Funktionalität beim Testen einer Anwendung nach Bundle-ID war in Version 2.8.1 defekt, was zu einem Fehler führte mit dem Titel „Kein Zielanwendungspfad über Testkonfiguration angegeben: ...“. 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.

Einige Bildschirme können aufgrund einer falschen associatedText-Eigenschaft, die gefunden wird (#1622), false positives mit 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 optiert haben, können Sie diese nicht mit einem iPhone 15 Pro-Simulator testen. Ein Fehler wurde bei Apple eingereicht.

Beim Sichten einer Verbesserung für unsere Regeln haben wir festgestellt, dass in XCTest verschachtelte Steuerungen nicht im Zugänglichkeitsbaum zurückgegeben werden. Ein Fehler wurde bei Apple eingereicht. (#1110)

In UIKit-Apps ist ein Bild ohne `accessibilityLabel` standardmäßig nicht mit unterstützender Technologie fokussierbar.
Die Eigenschaften, die wir verwenden, um die Fokussierbarkeit von Apple zu überprüfen, 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 der Behebung der folgenden false positives und werden diese Liste aktualisieren, sobald Korrekturen veröffentlicht werden.

In Scroll View
Möglicherweise werden Probleme für Text innerhalb von Banner-verhaltenden Elementen gemeldet. Um diese Elemente für Personen mit Bedarf an größerem Text 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 von VoiceOver nicht fokussierbar ist und innerhalb dessen fokussierbare Steuerungen verschachtelt sind, kann ActiveControlName ein false positive auf dem UIImageView melden. Das Entfernen der `accessibilityIdentifier` löst das Problem. Ein Fehler wurde bei Apple eingereicht. (#1633)

Label In Name and Label At Front
Diese beiden Regeln suchen nach dem sichtbaren Label einer Steuerung unter nahegelegenen Elementen, um den Regelstatus zu bestimmen. In einigen Ansichtshierarchien kann der falsche nahegelegene Text erkannt werden, wodurch diese Regeln fehlschlagen. (#1622)

Auf Android API 30 tritt bei einem der Standorte, die wir versuchen, Ergebnisse lokal zu speichern, ein Berechtigungsfehler auf. 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 hybriden und plattformübergreifenden Apps können wir unerwartete Ergebnisse zurückgeben, wenn sich Elemente in einem Scroll-View teilweise außerhalb des Bildschirms befinden. 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 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, diese Funktion wegen ihrer Sicherheitsvorteile zu nutzen, empfehlen wir, sie bei internen Testbuilds, bei denen Sie sicher Testdaten verwenden können um Sicherheitsbedenken auszuschließen, 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) auf den betroffenen Aktivitätsfenstern. setHideOverlayWindows(false)

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 mit Mock-Daten arbeitet, um Sicherheitsbedenken zu vermeiden. Siehe unser Leitfaden zum Aktivieren von Screenshots in Android-Apps.

Wenn Sie Ihr Build minifizieren, kommt es zu einem Absturz mit einem Fehlerprotokoll, das meldet, dass ein Adapter nicht gefunden werden konnte, wenn versucht wird, sich in die Axe DevTools-Bibliothek einzuloggen. 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 Fehler ähnlich dem folgenden 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)
    

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 wie `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` oder `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?` stoßen, beziehen Sie sich bitte auf Compose setTestTag API.

Wenn Sie diese Meldung erhalten, kann es sein, dass einige Regel-Ergebnisse nicht wie erwartet zurückgegeben werden, wenn diese Regel künstliche Intelligenz verwendet. 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 für Edit Text Name im Dashboard als benötigt Überprüfung angezeigt, wenn ein Fehler bei SDK-Version 5.5.0 und höher vermutet wird. Bitte bestätigen Sie das korrekte Verhalten manuell in diesem Fall.

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

Wenn der Screenshot auf der Scan-Detailseite fehlt, verhindert Ihre App möglicherweise die Aufnahme von Screenshots. Oft geschieht dies aus Sicherheitsgründen in Ihrer Produktionsanwendung. Ziehen Sie in Betracht, 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-Scan-Namen, die standardmäßig auf den Bildschirmtitel gesetzt sind, werden als vollständiger Klassenname einschließlich des Bundle-Identifiers angezeigt. In einer zukünftigen Veröffentlichung 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 heraus festlegen. (#1643)