Axe DevTools Mobile Versionshinweise zur Veröffentlichung am 11. November 2026

Komponenten-Versionen

iOS

• iOS SDK (axeDevToolsXCUI v5.0.0)

Wie aktualisieren: iOS SDK, iOS Analyzer Desktop-App

Android

• Android SDK (axe-devtools-android v10.0.0)
• Android Gradle Plugin (axe-devtools-android-plugin v2.0.0)
• Android Analyzer (Axe Accessibility Analyzer v4.2.0)

Wie aktualisierenJ: Android Gradle Plugin, Android Analyzer

Was gibt's Neues?

SDK

Da sich der Ruhestand des Mobile Dashboards nähert, wird die globale Regelkonfiguration jetzt im Axe Account festgelegt. Hier können Administratoren Einstellungen konfigurieren, welche Regeln im automatisierten Testlauf ausgeführt werden, und sie können auch Berechtigungen erteilen, damit Benutzer globale Einstellungen überschreiben und einzelne Regeln in ihren Tests ignorieren können. Wenn Überschreibungen nicht erlaubt sind, tut der Ignore-Aufruf nichts, und das SDK protokolliert warum. Bitte beachten Sie, dass wenn die Organisationseinstellungen nicht gelesen werden können, die Scans trotzdem ausgeführt werden. Jede Regel wird ausgeführt, und Code-spezifische Ignorierungen sind erlaubt. Nur eine Organisation, die Überschreibungen ausdrücklich deaktiviert, blockiert diese.

iOS

• Finden Sie einen Link zu Ihren Ergebnissen nach dem Hochladen. Nachdem ein Scan hochgeladen wurde, druckt das Protokoll jetzt View your results in Axe Developer Hub: <link>. Zielgerichtete Scans verlinken auf die Projektseite, und Auto Scan verlinkt auf seine Sitzung.
• Regeln werden jetzt auf AxeDevTools selbst ignoriert, zum Beispiel axe.ignoreRules(.colorContrast, .screenTitle), oder pro Element mit ignoreRules(onElementWithId:) / ignoreRules(onElementOfClass:). Eine falsch geschriebene Regel scheitert nun am Build, anstatt stillschweigend ausgeführt zu werden. (Breaking — siehe unten.)

Android

• Finden Sie einen Link zu Ihren Ergebnissen nach dem Hochladen. Nachdem ein Scan hochgeladen wurde, druckt das Protokoll einen Link zum Axe Developer Hub. Zielgerichtete Scans verlinken auf die Projektseite, und AutoScan verlinkt auf seine Sitzung.
• Sie ignorieren jetzt Regeln mit dem AxeRuleName-Enum, zum Beispiel axeDevTools.ignoreRules(AxeRuleName.COLOR_CONTRAST, AxeRuleName.SCREEN_TITLE). Um Regeln für ein Element zu überspringen, verwenden Sie ignoreRulesOnElementWithId("resource_id", AxeRuleName.TOUCH_TARGET_SIZE). Ein falsch geschriebener Regelname scheitert jetzt am Build, anstatt stillschweigend ignoriert zu werden. (Breaking, siehe unten.)
• Stellen Sie Regel-Ignorierungen einmal pro Sitzung bei zielgerichteten Tests ein. Übergeben Sie ignoreRules und ignoreRulesOnElementIds an die mobile: axeStartSession-Funktion; diese gelten für jeden zielgerichteten Scan, bis die Sitzung endet. (Hinweis: Auto Scan erlaubt keine individuellen Regel-Ignorierungen; es folgt nur den Regel-Einstellungen der Organisation.)

Fehlerbehebungen

iOS

• Verbesserungen der Genauigkeit der folgenden Regeln: Label im Namen, Label vorne, Touch-Zielgröße, Touch-Zielabstand
• Scans stürzen nicht mehr ab, wenn der Testläufer mit Xcode 16.2 oder anderen älteren Versionen als 16.4 gebaut wird
• Ruhigere Testprotokolle - das SDK druckt nicht mehr jedes Mal ins Testprotokoll, wenn es Analysen sendet

Android

• Verbesserte Genauigkeit der Regel „Label im Namen“
• Verbesserte Leistung für Auto Scan - der Testläufer wartet jetzt bis zu 10 Sekunden auf ein Netzwerk, bevor er sich anmeldet
• Verbesserte Leistung des Schwebe-Scan-Buttons des Axe Accessibility Analyzers bei Verwendung von TalkBack - Sie können ihn jetzt durch Wischen erreichen, und er behält den Fokus nach einem Scan oder nach dem Öffnen eines Menüs (Der Swipe-Fokus erfordert TalkBack-Version 16.2 oder höher)

Aktualisierungen

Android

• Das SDK, Analyzer und Beispielziele werden jetzt gegen Android SDK 37 gebaut (compileSdk / targetSdk 37). Der minSdk bleibt bei 26. Ihre App benötigt keine Änderungen.
• Java-Tests können nun direkt AxeAutoScan.skipScan(...) aufrufen, ohne .Companion
• resetIgnoredRules() ist nicht mehr veraltet, und Sie können es weiterhin verwenden

Veraltungen & Entfernungen

iOS

• Die Regel „Unzugängliche Aktion“ wurde entfernt. Scans führen sie niemals aus, und AxeRuleId.InaccessibleAction kompiliert nicht mehr. Entfernen Sie alle Verweise auf diese Regel aus Ihrem Testcode - jeglicher Code, den Sie hinzugefügt haben, um die Regel zu deaktivieren oder zu ignorieren, kann gelöscht werden.
• Die experimentellen Regel-APIs wurden entfernt. Der experimental-Schlüssel ist auch aus dem exportierten JSON entfernt.
• Der optInToSupportsDynamicType-Schlüssel wurde entfernt. Wenn Sie ihn immer noch in Ihrem Code haben, löschen Sie die Zeile, die ihn setzt.
• Die folgenden Mobile-Dashboard-APIs wurden jetzt entfernt. Diese wurden in einer früheren Veröffentlichung veraltet. Der Axe Developer Hub-Weg ist der einzige, der übrig bleibt:
  • getResult, tagResult, deleteResult, updateScanName, AxeDevToolsResultKey, AxeResult.tags — entfernt, kein Ersatz.
  • login(withAPIKey:toServer:) und startSession(apiKey:url:projectId:) — verwenden Sie statt dessen startScanSession(...) oder authenticate(...).
  • postResult(_:withTags:withScanName:) — verwenden Sie postResult(_:withScanName:), der jetzt nichts zurückgibt.
  • axeServiceUrl / axeServerUrl (für Auto Scan) — verwenden Sie axeAccountUrl.
  • AxeStatus.IGNORED - entfernt. Ignorierte Regeln erzeugen überhaupt kein Ergebnis mehr, daher erscheint "status":"IGNORED" nie im exportierten JSON.

Android

• Experimentelle Regeln wurden entfernt:
  • NestedElementName und NestedActiveControl existieren nicht mehr.
  • ignoreExperimental() und das experimental-Flag auf AxeRule sind nicht mehr vorhanden.
• AxeRuleViewHierarchy wurde im März 2025 veraltet und jetzt entfernt. Benutzerdefinierte Regeln sollten AxeRule erweitern und isApplicable / runRule mit AxeView überschreiben.
• Mobile-Dashboard-APIs wurden entfernt. Axe Developer Hub ist jetzt der einzige Upload-Pfad:
  • loginWithApiKey(...) und startSession(apiKey, projectId, serverUrl) — verwenden Sie startScanSession(apiKey, projectId, axeAccountUrl).
  • tagScanAs, getResult, deleteResult, AxeDevToolsResultKey, TagsSet — entfernt, kein Ersatz.
• ScanResultHandler.uploadToDashboard(uploadOnly) — verwenden Sie uploadToDashboard() ohne Argumente. Hinweis: Dies sendet Ergebnisse an Axe Developer Hub.
• Gradle-Plugin axeServerUrl — verwenden Sie axeAccountUrl.
• AxeStatus.IGNORED - entfernt. Ignorierte Regeln erzeugen jetzt kein Ergebnis mehr, sodass "status":"IGNORED" nie in exportiertem JSON erscheint.

Breaking Changes

iOS

• Die minimal erforderliche iOS-Version ist jetzt 17. UI-Testziele, die immer noch auf iOS 16 abzielen, müssen ihr Bereitstellungsziel anheben. Der Betrieb auf iOS 16-Geräten wird nicht mehr unterstützt.
• Das Ignorieren von Regeln wurde von axe.configuration entfernt, und axe.configuration wurde entfernt. Alte Aufrufe schlagen mit einer Nachricht, die den neuen Aufruf benennt, fehl:
  • axe.configuration.ignore(rules:) - verwenden Sie axe.ignoreRules(...)
  • axe.configuration.ignore(rulesFor:) - verwenden Sie axe.ignoreRules(onElementWithId:_:) oder ignoreRules(onElementOfClass:_:)
  • axe.configuration.customRules.insert(rule) - verwenden Sie axe.addCustomRule(rule)
  • Das Ignorieren benutzerdefinierter Regeln und das Wiedereinschalten einer Regel werden nicht mehr unterstützt
• AxeRuleId-Werte sind jetzt lowerCamelCase (zum Beispiel wird .ColorContrast zu .colorContrast). Swift-Code, der die alte Schreibweise verwendet, kompiliert nicht mehr. Objective-C, exportiertes JSON, Axe Developer Hub und Appium ignoreRules-Einstellungen bleiben unverändert.
• http://-Konten-URLs werden abgelehnt, wenn Sie sich mit einem API-Schlüssel anmelden. Kunden vor Ort, deren Konten-URL mit http:// beginnt, müssen zu https:// wechseln.
• Entfernte APIs unter Veraltungen & Entfernungen schlagen fehl, wenn sie kompiliert werden.

Android

• Die Regel-Ignorier-APIs haben sich geändert. Alte Aufrufe kompiliert nicht mehr:
  • ignoreRules(listOf("ColorContrast")) - verwenden Sie ignoreRules(AxeRuleName.COLOR_CONTRAST)
  • ignoreByViewIdResourceName(id, listOf(...)) - verwenden Sie ignoreRulesOnElementWithId(id, AxeRuleName.X, ...)
  • ignoreExperimental() - entfernen Sie den Aufruf.
• TouchSizeWcag ist jetzt TouchTargetSize, was mit iOS und Axe Developer Hub übereinstimmt. Aktualisieren Sie allen Code, Filter oder Dashboards, die nach dem alten Namen suchen.
• Benutzerdefinierte Regeln, die AxeRuleViewHierarchy erweitern oder das experimental-Flag an AxeRule übergeben, werden nicht mehr kompiliert.
• Gradle-Plugin: Builds, die noch axeServerUrl im axeDevTools { }-Block setzen, müssen zu axeAccountUrl wechseln.
• Entfernte APIs unter Veraltungen & Entfernungen schlagen fehl, wenn sie kompiliert werden.

Bekannte Probleme

Neue Probleme

Sollten 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 behoben ist oder ein identifizierter Workaround verfügbar ist, falls keiner aufgeführt wurde.

iOS

Falsch positive Ergebnisse für die Regeln "Supports Dynamic Type" und "Clipped Text"

Die "Supports Dynamic Type" und "Clipped Text"-Regeln (iOS 17 und höher) verwenden Ergebnisse aus Apples Barrierefreiheitsprüfung. Diese Prüfung markiert gelegentlich Text, der korrekt skaliert oder vollständig sichtbar ist, und diese Regeln melden, was Apple zurückgibt. Die meisten Fehler dieser Regeln sind reale Probleme, deshalb empfehlen wir nicht, sie als Gruppe zu ignorieren. Dieses Problem wurde Apple gemeldet, und wir arbeiten daran, diese Falschmeldungen zu reduzieren.

Um einen Fehler zu bestätigen, aktivieren Sie Größere Barrierefreiheitsgrößen unter Settings > Accessibility > Display & Text Size > Larger Text. Gehen Sie durch jede Textgröße, von der Standard- bis zur größten Größe, und prüfen Sie, ob der markierte Text skaliert und vollständig sichtbar bleibt. Text kann bei der größten Größe in Ordnung aussehen, aber bei einer dazwischenliegenden Größe brechen.

Wenn der Fehler ein Falschmeldung ist, ignorieren Sie die Regel bei diesem Element über dessen Barrierefreiheitskennung. Wir empfehlen nicht, die Regel für den gesamten Scan oder nach Klassenname zu ignorieren, da dies auch echte Fehler verbergen kann.

Android

Falsch positive Ergebnisse beim Scannen von Karten

Derzeit ist es nicht möglich, genau zu bestimmen, ob ein Element auf dem Bildschirm innerhalb einer Karte enthalten ist, daher könnten unsere Regeln versehentlich Kartenpins scannen und falsch positive Ergebnisse liefern. Dies ist ein Problem, wie das Android-System Karten an den Barrierefreiheitsdienst meldet.

Verwenden Sie unsere Regel-Ignorier-API, um Ihre Karte oder Kartenpins mit ihren IDs von der Überprüfung auszuschließen.

Erfahren Sie mehr über das Ignorieren von Regeln.

Apps, die mit Unity gebaut wurden, können nicht gescannt werden

Axe DevTools Mobile kann den auf dem Bildschirm angezeigten Inhalt von mit der Unity-Game-Engine gebauten Apps nicht scannen. Dies betrifft automatisierte Scans mit der Android-Bibliothek sowie Scans mit der Accessibility Analyzer-App. Ergebnisse zeigen nur Prüfungen auf Bildschirmebene - für Regeln wie Bildschirmorientierung und Bildschirmtitel - und nichts für die Schaltflächen, Texte oder Schalter der App.

Derzeit gibt es keine Lösung.

Behobene Probleme

iOS

Entfernt: veraltetes Falsch positives für Bildschirmbezeichnung und aktiven Steuerungsnamen

Wir haben einen veralteten Eintrag über Falsch positive für aktiven Steuerungsnamen auf einem UIImageView der ein accessibilityIdentifier. Dieses Problem betraf nur v2.11.0 und wurde im Juni 2024 behoben. Der aktive Steuerungsname wird bei diesen Bildern in UIKit-Apps nicht mehr ausgeführt. Der Bildschirmbezeichnungsname meldet sie stattdessen als "Zur Überprüfung erforderlich" (siehe Ergebnisse der Überprüfung der Bildansicht Namensregel für UIKit-Apps).