Axe DevTools Mobile Versionshinweise vom 20. Februar 2025

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

20. Februar 2025

Not for use with personal data

Komponentenversionen

  • iOS SDK (axeDevToolsXCUI v2.14.0)
  • iOS Analyzer (axe-devtools-mobile-analyzer v1.4.8)
  • iOS Appium Treiber (axe-appium-xcuitest-driver v1.2.0)

Wie zu aktualisieren: iOS SDK, iOS Analyzer, iOS Appium Treiber

Was ist neu?

iOS Appium Treiber

Die Ignore Rules Funktion ist jetzt für den iOS Appium-Treiber verfügbar! Informationen zur Implementierung finden Sie in unserer Ignore Rules Dokumentation für Appium. Um mehr über das Ignorieren von Regeln zu erfahren, wenn Sie Scans zur Barrierefreiheit durchführen, sehen Sie sich unsere Appium Einrichtungsdokumentation an.

iOS SDK

Wir haben die Netzwerkprotokollierungsnachrichten aussagekräftiger gestaltet. Zuvor enthielten alle Erfolgsmeldungen nur die Nachricht 200 OK. Jetzt werden aussagekräftigere Nachrichten, wie DEQUE LOG: 200 OK - User verified. Successfully logged in., in der Konsole angezeigt.

iOS Korrekturen

  • Verbesserungen bei der Genauigkeit der folgenden Regeln: Farbkontrast, Zugehöriger Text, Label Im Namen und Label Vorne

Bekannte Probleme

Wenn Sie eines der unten aufgeführten Probleme haben, kontaktieren Sie uns bitte unter helpdesk@deque.com oder support.deque.com. Wir können Sie dann benachrichtigen, sobald es gelöst ist, oder über einen identifizierten Workaround, falls keiner aufgeführt ist.

important
  • Axe DevTools Mobile automatisierte Tests laufen auf nativen iOS-, nativen Android- und React Native-Anwendungen. Bitte kontaktieren Sie Ihren Deque-Ansprechpartner für Barrierefreiheitslösungen in Ihrem Technologie-Stack.
  • Während Sie möglicherweise einige Ergebnisse von Webansichten oder gerenderten PDFs erhalten, empfehlen wir dringend, Tests mit Axe DevTools for Web oder Axe Monitor für die umfassendsten Barrierefreiheitsprüfungen für das Web durchzuführen.

iOS

Kann keine Scans auf physischen Geräten mit iOS Analyzer 1.4.7 ausführen

Eine Konfigurationseinstellung im iOS Analyzer 1.4.7 verhindert das Ausführen von Scans und gibt die Nachricht „Test fehlgeschlagen“ zurück. Um Scans auf einem physischen Gerät durchzuführen, aktualisieren Sie auf das neueste iOS Analyzer-Projekt.

Fehler im Analyzer-Projekt & Testen nach Bundle-ID in 2.8.1

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

„Konnte AxeResult nicht serialisieren“ Fehler im Analyzer-Projekt v1.2.0 & SDK v2.12.3

Das Scannen einiger Anwendungen mit dieser Version des Analyzers und SDKs würde zu einem Fehler „Konnte AxeResult nicht serialisieren“ 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.

Falsch Positiv: LabelImName und LabelVorne in SwiftUI & plattformübergreifenden Apps

Einige Bildschirme können aufgrund einer inkorrekten Eigenschaft associatedText (#1622) falsche Positive mit LabelImName und LabelVorne melden

Supports Dynamic Type Regel funktioniert nicht mit iOS 15 Pro-Simulator

Es gibt ein Problem, das den iPhone 15 Pro-Simulator betrifft, das die Ausführung der Supports Dynamic Type-Regel verhindert. Wenn Sie für die Supports Dynamic Type-Regel registriert sind, können Sie diese nicht mit einem iPhone 15 Pro-Simulator testen. Ein Fehler wurde bei Apple gemeldet.

Regeln gegen verschachtelte Steuerelemente

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

ImageView Name Regel muss Überprüfungsergebnisse für UIKit Apps ansehen

In UIKit-Apps ist ein Bild ohne `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 das Bild gesetzt ist. Aufgrund dieses unerwarteten Verhaltens werden Ergebnisse für ImageView Name-Probleme in UIKit-Apps als Muss Überprüft Werden gemeldet. Ein Fehlerbericht wurde bei Apple eingereicht. (#1633)

Falsch Positiv: In Scroll View, Label Im Namen, Label Vorne und v2.11.0 Image View Name & ActiveControlName

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

In Scroll View
Möglicherweise werden Probleme für Text innerhalb von Banner-ähnlichen Elementen gemeldet. Um diese Elemente für diejenigen, die größere Texte benötigen, 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 von VoiceOver nicht fokussierbar ist, und es fokussierbare Steuerelemente darin verschachtelt hat, kann ActiveControlName möglicherweise ein falsches Positiv auf dem UIImageView 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 in benachbarten Elementen, um den Regelstatus zu bestimmen. In einigen Anzeigestrukturen kann fälschlicherweise der falsche Text in der Nähe erkannt werden, was dazu führt, dass diese Regeln fehlschlagen. (#1622)

Android

Berührungsziel-Abstand und Jetpack Compose

Die Regel für den Berührungsziel-Abstand wird derzeit für keine Slider-Komponenten ausgeführt, die in Jetpack Compose geschrieben wurden. Derzeit kann keine Maßnahme ergriffen werden. Trotzdem kommt bald eine Lösung!

Fehler beim lokalen Speichern von Ergebnissen auf API 30

Auf Android API 30 haben wir einen Berechtigungsfehler bei einem der Speicherorte, 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
//    }
}

Please note that this code should only be commented out for API 30 as it will cause problems when saving locally for other API levels.

Scroll-Erkennung bei Hybrid- und plattformübergreifenden Apps

In einigen Hybrid- und plattformübergreifenden Apps erhalten wir möglicherweise unerwartete Ergebnisse, wenn Elemente in einer Scroll-Ansicht teilweise außerhalb des Bildschirms sind. Um ein Element auf Barrierefreiheit zu testen, stellen Sie sicher, dass es vollständig auf dem Bildschirm ist, bevor Sie den Scan durchführen.

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 diese Funktion aus Sicherheitsgründen verwenden möchten, empfehlen wir, sie für interne Testversionen deaktiviert zu lassen, in denen Sie Testdaten sicher verwenden und Sicherheitsbedenken auf diese Weise ausschließen 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 setHideOverlayWindows(false) für die betroffenen Aktivitätsfenster.

Fehlender Screenshot (Schwarzes Kästchen) im Dashboard

Um die vollständige 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 Mock-Daten verwendet, um Sicherheitsbedenken zu vermeiden. Sehen Sie sich unseren Leitfaden zum Aktivieren von Screenshots in Android-Apps.

Absturz, wenn `minifiedEnabled` auf true gesetzt ist

Wenn Sie Ihren Build minifizieren, kommt es zu einem Absturz mit einem Fehlerprotokoll, das berichtet, dass ein Adapter nicht gefunden werden konnte, wenn Sie versuchen, 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 könnte versuchen, die axeDevTools-Bibliothek zu minifizieren, was zu einem Fehler führt, der wie folgt aussieht:

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:
Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)
oder: No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?

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 so aussieht `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` oder `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, ziehen Sie bitte das Compose setTestTag APIzurate.

Protokollmeldung:MlKitContext has not been initialized

Wenn Sie diese Meldung erhalten, kehren möglicherweise einige Regel-Ergebnisse nicht wie erwartet zurück, wenn diese Regel künstliche Intelligenz verwendet. Betroffene Regeln sind Farbkontrast, fokussierbarer Text und geschachtelter Elementname. (#841)

MAUI: Regel für Edit-Text-Namen

Aufgrund von Einschränkungen der MAUI-App-Architektur in der Android-Umgebung wird die Regel für Edit-Text-Namen 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 in diesem Fall das korrekte Verhalten manuell.

Native Android: Benutzerdefinierte Dialoge / Modals

Wenn Sie benutzerdefinierte Dialoge oder Modals implementieren, die die nativen Steuerelemente nicht erweitern, können Sie Ergebnisse von Ansichten hinter dem Modal erhalten. In diesem Fall empfehlen wir, unser Werkzeug nicht gegen diese benutzerdefinierten Modals oder Dialoge auszuführen, sondern sie stattdessen manuell auf das gewünschte Verhalten mit unterstützender Technologie zu überprüfen.

Web-Dashboard

Fehlender Screenshot

Wenn der Screenshot auf der Detailseite des Scans fehlt, könnte Ihre App verhindern, dass Screenshots aufgenommen werden. Oft geschieht dies aus Sicherheitsgründen in Ihrer Produktionsanwendung. Erwägen Sie, diese Anforderung für Ihren Test-Build zu entfernen, um die vollständige Funktionalität im Axe DevTools Mobile-Dashboard zu ermöglichen.

Einige Android-Scan-Namen sind unformatiert

Einige Android-Scan-Namen, die standardmäßig dem Bildschirmtitel zugewiesen sind, werden als vollständiger Klassenname einschließlich der Bundle-ID angezeigt. In einer zukünftigen Version wird dies behoben, sodass der Bildschirmtitel in einen besser lesbaren Namen formatiert wird. Als Workaround können Sie den Scan-Namen über das Dashboard oder Frameworks einstellen. (#1643)