Axe DevTools Mobile Versionshinweise zum 18. September 2024
18. September 2024
Komponenten-Versionen
- iOS SDK (axeDevToolsXCUI v2.12.4)
- iOS Analyzer (axe-devtools-mobile-analyzer v1.4.0)
- iOS Appium-Treiber (axe-appium-xcuitest-driver v1.0.0)
- Android Appium-Treiber (axe-appium-uiautomator2-driver v1.0.0)
Update-Anleitung: iOS SDK, iOS Analyzer
Was ist neu?
Appium-Treiber 🎉
Wir freuen uns, zwei neue Appium-Treiber für eine branchenführende Appium-Barrierefreiheitstestlösung anzukündigen. Unsere Treiber werden von unseren bewährten SDKs unterstützt, die Ihnen die gleichen robusten und hochpräzisen Ergebnisse liefern, die Sie mit allen unseren Axe DevTools Mobile-Komponenten erhalten. Unsere Appium-Treiber decken alle verfügbaren mobilen Regeln von Deque ab und Einrichtung dauert nur wenige Minuten.
Verwenden Sie derzeit das Axe DevTools Appium-Plugin? Schauen Sie sich unsere Migrationsanleitung an, um mit den neuen Treibern zu beginnen.
Fehlerbehebungen
iOS SDK und Analyzer
- Mehrere Verbesserungen zur Genauigkeit der Farbkontrastregel
- Ein Fehler bei der Serialisierung wurde behoben, der dazu führte, dass einige Scans fehlschlugen
Bekannte Probleme
Wenn Sie eines der unten genannten Probleme erleben, kontaktieren Sie uns bitte unter helpdesk@deque.com oder support.deque.com. Wir können Sie dann benachrichtigen, sobald es gelöst ist, oder eine identifizierte Umgehungslösung anbieten, falls keine aufgeführt ist.
- Axe DevTools Mobile automatisierte Tests laufen auf nativen iOS-, nativen Android- und React Native-Anwendungen. Bitte kontaktieren Sie Ihren Deque-Ansprechpartner für Barrierefreiheitstestlösungen auf Ihrem Tech-Stack.
- Während Sie möglicherweise einige Ergebnisse von Web-Ansichten oder gerenderten PDFs erhalten, empfehlen wir dringend, Axe DevTools für Web oder Axe Monitor für die umfassendsten Barrierefreiheitstests für das Web zu verwenden.
iOS
Fehler im Analyzer-Projekt & Testen nach Bundle-ID in 2.8.1
Die Funktion zum Testen einer Anwendung nach Bundle-Identifier war in Version 2.8.1 defekt, was zu einem Fehler führte, der mit "Kein Ziel-Anwendungspfad über Testkonfiguration angegeben: ..." betitelt wurde. 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.
False Positive: LabelInName und LabelAtFront in SwiftUI- & plattformübergreifenden Apps
Einige Bildschirme melden möglicherweise falsch positive Ergebnisse mit LabelInName und LabelAtFront aufgrund einer falschen associatedText-Eigenschaft (#1622)
Supports Dynamic Type-Regel funktioniert nicht mit iOS 15 Pro-Simulator
Ein Problem betrifft den iPhone 15 Pro Simulator, das verhindert, dass die Supports Dynamic Type-Regel ausgeführt wird. Wenn Sie für die Supports Dynamic Type-Regel angemeldet sind, können Sie diese nicht mit einem iPhone 15 Pro-Simulator testen. Ein Fehler wurde bei Apple gemeldet.
Regeln gegen geschachtelte Steuerelemente
Bei der Betrachtung einer Verbesserung unserer Regeln haben wir festgestellt, dass in XCTest geschachtelte Steuerelemente nicht im Barrierefreiheitsbaum zurückgegeben werden. Ein Fehler wurde bei Apple gemeldet. (#1110)
ImageView Name-Regel benötigt Überprüfung der Ergebnisse für UIKit-Apps
In UIKit-Apps ist ein Bild ohne `accessibilityLabel` standardmäßig nicht mit unterstützenden Technologien fokussierbar.
Die Eigenschaften, die wir verwenden, um die Fokussierbarkeit von Apple zu überprüfen, können ungenau sein, wenn ein `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)
False Positive: In Scroll-View, Label In Name, Label at Front und v2.11.0 Image View Name & ActiveControlName
Wir arbeiten aktiv an Lösungen für die folgenden falsch positiven Ergebnisse und werden diese Liste aktualisieren, sobald Lösungen verfügbar sind.
In Scroll View
Möglicherweise werden Probleme für Text innerhalb von Banner-verhaltenden Elementen gemeldet. Um diese Elemente für diejenigen verfügbar zu machen, die größere Text benötigen, verwenden Sie UILargeContentViewer. (#622)
v2.11.0 Image View Name & Active Control Name
Wenn ein UIImageView ein `accessibilityIdentifier` hat, aber nicht per VoiceOver fokussierbar ist, und es fokussierbare Steuerelemente innerhalb davon gibt, kann ActiveControlName bei dem UIImageView möglicherweise ein falsch positives Ergebnis melden. Durch Entfernen des `accessibilityIdentifier` wird das Problem behoben. Ein Fehler wurde bei Apple gemeldet. (#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 Ansichtshierarchien kann der falsche nahegelegene Text festgestellt werden, was dazu führt, dass diese Regeln fehlschlagen. (#1622)
Android
Analyzer-App: Floating Action Button verschwindet
Mit API 31 (Android 12) wurde die Möglichkeit eingeführt, nicht-systemeigene 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 zur Verbesserung der Sicherheit zu nutzen, empfehlen wir, sie für interne Testaufbauten deaktiviert zu lassen, bei denen Sie sicher Testdaten verwenden und Sicherheitsbedenken so 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.
Screenshot fehlt (schwarze Box) im Dashboard
Um die volle Funktionalität der 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 Simulationsdaten arbeitet, um Sicherheitsbedenken zu vermeiden. Schauen Sie sich unsere Anleitung zum Aktivieren von Screenshots in Android-Apps an.
Absturz, wenn `minifiedEnabled` auf true gesetzt ist
Wenn Sie Ihr Build minimieren, kommt es zu einem Absturz mit einem Fehlerprotokoll, das 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)
Builds mit aktiviertem r8 werfen einen Fehler
Ein Build mit aktiviertem r8 kann versuchen, die axeDevTools-Bibliothek zu minimieren, was zu einem Fehler führen kann, der ähnlich lautet 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)
To resolve this error add the following line to your ProGuard file to keep axeDevTools classes:keep class com.deque.** { *; }
Fehlermeldung ähnlich wie:
Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)
oder: No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?
Wenn Sie auf einen Fehler stoßen wie `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` oder `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, beziehen Sie sich bitte auf Compose setTestTag API.
Protokollnachricht:MlKitContext has not been initialized
Wenn Sie diese Nachricht sehen, können einige Regelergebnisse nicht wie erwartet zurückkehren, wenn diese Regel künstliche Intelligenz verwendet. Betroffene Regeln sind unter anderem Farbkontrast, fokussierbarer Text und verschachtelter Elementname. (#841)
MAUI: Regel für Edit-Text-Namen
Aufgrund von Einschränkungen der MAUI-App-Architektur im Android-Ökosystem wird die Regel für Edit-Text-Namen im Dashboard als Überprüfung erfordert angezeigt, wenn ein Fehler für SDK-Version 5.5.0 und höher vermutet wird. Bitte überprüfen Sie in diesem Fall das korrekte Verhalten manuell.
Native Android: Benutzerdefinierte Dialoge/Modals
Wenn Sie benutzerdefinierte Dialoge oder Modals implementieren, die die nativen Steuerungen nicht erweitern, können Ergebnisse für Ansichten hinter dem Modal angezeigt werden. In diesem Fall empfehlen wir, unser Tool nicht gegen diese benutzerdefinierten Modals oder Dialoge auszuführen, sondern sie manuell zu überprüfen, um sicherzustellen, dass sie wie gewünscht mit unterstützender Technologie funktionieren.
Web-Dashboard
Fehlender Screenshot
Wenn der Screenshot auf der Scan-Detailseite fehlt, kann es sein, dass Ihre App verhindert, dass Screenshots erstellt werden. Oft geschieht dies aus Sicherheitsgründen in Ihrer Produktionsanwendung. Ziehen Sie in Betracht, diese Anforderung für Ihren Testbuild zu entfernen, um die volle Funktionalität im Axe DevTools Mobile Dashboard zu ermöglichen.
Einige Android-Scan-Namen sind nicht formatiert
Einige Android-Scan-Namen, die standardmäßig dem Bildschirmtitel entsprechen, werden als vollständiger Klassenname einschließlich des Bundle-Identifiers angezeigt. In einer zukünftigen Version wird dies so gelöst, dass der Bildschirmtitel in einen besser lesbaren Namen formatiert wird. Als Workaround können Sie den Scan-Namen vom Dashboard oder den Frameworks festlegen. (#1643)
