Axe DevTools Mobile Release-opmerkingen 23 oktober 2026

Bij het scannen van een scherm met grote of complexe weergavehiërarchieën kan de axeScan opdracht langer dan 60 seconden duren om te voltooien. Appiums WebDriverAgent (WDA)-proxy past een standaard time-out van 60 seconden toe op onbekende opdrachten, en axeScan valt in die categorie. Als de scan binnen die tijd niet is voltooid, annuleert WDA het verzoek en geeft de test een time-outerror

Om de time-out per opdracht voor WDA-geproxiede opdrachten zoals axeScante overschrijven, raden we de volgende instellingen aan in uw Appium-capaciteiten:

• appium:commandTimeouts: 240000 (4 minuten)
• appium:wdaConnectionTimeout: 30000 (5 minuten)

Note: appium:newCommandTimeout is a different setting. It controls how long Appium waits between commands from the test script. That is not the cause of this issue. The relevant setting is appium:commandTimeouts

Als u op Xcode 27 werkt en een Mobile Analyzer Desktop-app ouder dan 2.0.0 gebruikt, kan de app de iOS-simulator niet openen. Het mislukt wanneer het probeert te starten /Applications/Xcode.app/Contents/Developer/Applications/Simulator.app U kunt geen simulatiegebaseerde scan starten totdat dit is opgelost.

Om scans uit te voeren met een simulator op Xcode 27, update de Desktop Analyzer naar versie 2.0.0+. Met deze update kunt u er rekening mee houden dat toegankelijkheidsresultaten nu te vinden zijn in Axe Developer Hub.

De Axe DevTools SDK gebruikt Apple's Vision-framework om tekst van het scherm te lezen voor verschillende toegankelijkheidsregels (bijv. Kleurcontrast, Botsende weergaven, elke regel die afhankelijk is van door Vision-gedetecteerde tekst).

Vision geeft niet altijd dezelfde gedetecteerde tekst terug tussen herhaalde uitvoeringen van hetzelfde scherm. Wanneer Vision de tekst op een besturingselement mist, zullen regels die afhankelijk zijn van die tekst niet worden uitgevoerd voor dat element tijdens die scan. Bevindingen kunnen inconsistent lijken tussen twee scans van hetzelfde scherm - een probleem dat in één scan faalt, kan in de volgende ontbreken.

Wanneer een op Vision gebaseerde regel een foutmelding geeft, is de foutmelding zelf nauwkeurig. De inconsistentie ligt in of de regel wel of niet wordt uitgevoerd. Om deze kwestie te overwinnen, probeer het volgende:

• Voer de scan opnieuw uit. Als een op Vision gebaseerde regel werd overgeslagen voor een besturingselement, wordt het vaak opgepikt bij een volgende scan van hetzelfde scherm.
• Behandel elke storing van een op Vision gebaseerde regel als geldig - als Kleurcontrast een besturingselement markeert, is het contrastprobleem echt en moet het worden aangepakt.
• Voor handmatige verificatie, gebruik de Deque University-referentie voor het relevante WCAG-succescriterium. (Links zijn te vinden onderaan elke regelpagina's.)

Op iOS 26 en later, als een scherm tekst bevat met een procentteken (bijv. een tekstlabel met "50% Korting"), kan de Supports Dynamic Type-regel als Onvolledig rapporteren in plaats van geslaagd of mislukt. Deze regel is afhankelijk van een toegankelijkheidscontrole die door Apple wordt geleverd, en die controle stopt de testuitvoering wanneer procenttekens worden aangetroffen. Om je tests te laten doorgaan, slaat onze regel de controle voor dat scherm over en rapporteert onvolledig voor elk element dat een procentteken bevat. Alle andere regels worden normaal uitgevoerd op het scherm en andere schermen worden niet beïnvloed.

Er is geen actie vereist, aangezien je scan nog steeds wordt voltooid. Om de ondersteuning van Dynamic Type voor deze schermen te controleren, verhoog de lettergrootte op je apparaat onder **Instellingen** > **Toegankelijkheid** > **Weergave & Tekstgrootte** > **Grote tekst**, en bevestig of de tekst op het scherm zich correct aanpast. Dit probleem is gerapporteerd aan Apple. (#2985)

De Kleurcontrast-regel gebruikt Apple's Vision-framework (Optical Character Recognition, of OCR) om tekst binnen de grenzen van een element te lezen. OCR kan af en toe kleine op icoon lijkende glyphs – zoals terug-pijlsymbolen (<), bullets, decoratieve symbolen – verkeerd identificeren als tekst. Wanneer dat gebeurt, voert de Kleurcontrast-regel uit op een element dat geen leesbare tekst bevat, wat een resultaat kan opleveren voor een alleen-icoonknop. Omdat OCR-uitvoer niet deterministisch is over scans heen, kan hetzelfde element verschijnen in de Kleurcontrast-resultaten in de ene scan en worden gerapporteerd als "NIET VAN TOEPASSING" in de volgende. Dit is een bekend kenmerk van OCR, geen fout in de regel.

Om deze kwestie te omzeilen, kun je de ignore API's gebruiken om Kleurcontrast-resultaten voor de betrokken elementen te onderdrukken.

Flutter mappt niet AppBar.title op de native schermtitel-eigenschap - UIViewController.title, wat ervoor zorgt dat de Schermtitel-regel faalt op alle Flutter-schermen, ongeacht of er een beschrijvende titel aanwezig is.

Dit is een bekende Flutter-platformbeperking die wordt bijgehouden in flutter/flutter#185894.

Bij het uitvoeren van toegankelijkheidscontroles op kleinere schermformaten of met kleinere lettergroottes, kan de Kleurcontrast-regel valse positieven rapporteren voor verloopachtergronden. In dergelijke gevallen is het mogelijk niet in staat om de voorgrondkleur te bepalen en vergelijkt in plaats daarvan achtergrondkleuren met elkaar, wat resulteert in een mislukking.

Om deze kwestie te omzeilen, probeer toegankelijkheidscontroles uit te voeren op grotere apparaten. Alternatief kun je ervoor kiezen de regel in je tests te negeren en Kleurcontrast handmatig voor deze weergaven te controleren.

Apple's toegankelijkheids-API's kunnen webinhoud binnen WKWebView onterecht als "isVisible" rapporteren, zelfs wanneer de webweergave bedekt is door native overlays (zoals modale vensters, waarschuwingen of andere native UI-elementen). Dit gebeurt omdat het toegankelijkheidssysteem controleert of de WKWebView-container zelf zichtbaar is, in plaats van of de webinhoud daadwerkelijk vrij en waarneembaar is voor de gebruiker.

iOS 26 bevat een toegankelijkheidsbug waarbij standaard stappentoetsen niet "gedimd" worden aangekondigd door Assistive Technology om aan te geven dat ze niet ingeschakeld zijn. Als gevolg hiervan zien de iOS-regels deze knoppen ook als ingeschakeld, zelfs als ze dat niet zijn. Er is een bugrapport ingediend bij Apple, maar totdat dit is opgelost, kunnen de volgende regels resultaten rapporteren over uitgeschakelde stappentoetsen: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze bug oplost, moet de oplossing zijn om [de regels te negeren](ios-ignore-rule). De standaard stappentoetsen hebben de identificatoren "Decrement" en "Increment" en kunnen indien nodig worden genegeerd op identificator.

Our Color Contrast rule depends on Machine Learning to detect text, which ensures that the text being scanned is visible to users of your application. In cases where the text contained in a view is the same color as the background, our Machine Learning algorithm is unable to detect if any text is present, so the Color Contrast rule does not run on this view.

Sommige schermen kunnen valse positieven rapporteren met LabelInName en LabelAtFront vanwege een onjuiste associatedText eigenschap die wordt gevonden (#1622)

Bij het bekijken van een verbetering voor onze regels, hebben we ontdekt dat in XCTest geneste besturingselementen niet worden geretourneerd in de toegankelijkheidsboom. Er is een bug ingediend bij Apple. (#1110)

In UIKit-apps is een afbeelding zonder een `accessibilityLabel` standaard niet toegankelijk met ondersteunende technologie.
De eigenschappen die we gebruiken om de focusbaarheid te controleren van Apple, kunnen onnauwkeurig zijn wanneer een `accessibilityIdentifier` op de afbeelding is ingesteld. Vanwege dit onverwachte gedrag zullen resultaten voor ImageView Naam-kwesties in UIKit-apps als Te Herzien worden gerapporteerd. Er is een bugrapport ingediend bij Apple. (#1633)

We zijn actief bezig met oplossingen voor de volgende valse positieven en zullen deze lijst bijwerken zodra oplossingen worden uitgebracht.

In Scroll View
Tekst binnen elementen die zich als banners gedragen, sticky headers/footers, zwevende actieknoppen en aangepaste tabbalken kan worden gemarkeerd met een "Te Herzien" of "Mislukt" bericht. Om deze elementen beschikbaar te maken voor degenen die grotere tekst nodig hebben, gebruik UILargeContentViewer. (#622, #2077)

v2.11.0 Image View Name & Active Control Name
Als een UIImageView een accessibilityIdentifier ingesteld heeft maar niet toegankelijk is via VoiceOver, en het heeft focusbare bedieningselementen erin genesteld, dan kan Active Control Name een vals positief resultaat geven op de UIImageView. Het verwijderen van de accessibilityIdentifier lost het probleem op. Er is een bug gemeld bij Apple. (#1633)

Label In Name and Label At Front
Deze twee regels zoeken naar een zichtbaar label van een control tussen nabije elementen om de regelstatus te helpen bepalen. In sommige weergavehiërarchieën kan de verkeerde nabije tekst worden gedetecteerd, waardoor deze regels falen. (#1622)

De Floating Action Button (FAB) van de Android Accessibility Analyzer is niet compatibel met Talkback veegnavigatie in Talkback-versies ouder dan 16.2. Met de release van 16.2 heeft Talkback een bug in hun code gepatcht om veegfocus voor overlay FABs mogelijk te maken.

Houd er rekening mee dat dit puur een Talkback-bug is, die niet toestond dat FABs weergegeven in toegankelijkheidsoverlays focus kregen of verloren via vegen. De recente upgrade van onze Accessibility Analyzer-app maakt het mogelijk om meer soorten apps te scannen; dus u kunt dit probleem nu pas opmerken.

Dit probleem kan worden opgelost door Talkback bij te werken naar versie 16.2 of later.

De Label op Voorgrond-regel controleert dat het zichtbare label van een element aan het begin van de aangekondigde tekst komt. Een regel mislukt mogelijk wanneer de zichtbare tekst van een interactief element een afkorting (bijv. "GB", "km") of een verduisterde / afgekorte identificator bevat, en de toegankelijkheidsaankondiging uit de weergegeven woorden bestaat (bijv. "gigabytes", "kilometers"), hoewel dit het aanbevolen patroon is om afgekorte of afgekorte inhoud schermlezer-vriendelijk te maken.

Als het eerste deel van het zichtbare label van een interactief element overeenkomt met het begin van de schermlezer-aankondiging en alleen het afgekorte / verduisterde gedeelte verschilt, kan het gemarkeerde resultaat veilig worden genegeerd. Verifieer met een schermlezer dat de volledige aankondiging correct wordt voorgelezen.

Bij het gebruik van decoratieve tekst in weergaven zoals "Contacticonen", is het mogelijk om een toegankelijkheidsprobleem te introduceren. Als u een tekstweergave gebruikt om letters weer te geven in plaats van afbeeldingen te genereren met de gewenste letters als vectoren, en u verklaart vervolgens dat tekstweergave als niet belangrijk voor toegankelijkheid, kunnen we niet betrouwbaar bepalen of u een toegankelijkheidsschending hebt geïntroduceerd.

Als u focusbare tekst bewerkt om twee of minder tekens te negeren, kunt u per ongeluk veel een-woordknoppen in verschillende talen negeren (bijv. „OK”, „No”, „Sí”). Om deze problemen te voorkomen, moet u de gewenste letters uit het woord halen dat u wilt weergeven in het pictogram en de letters als onderdeel van de afbeelding genereren in plaats van als aparte tekstweergaven. `FocusableText` zal dan niet op die weergaven draaien.

Flutter mappt niet AppBar.title op de native schermtitel-eigenschap - Activity.setTitle, wat ervoor zorgt dat de Schermtitel-regel faalt op alle Flutter-schermen, ongeacht of er een beschrijvende titel aanwezig is.

Dit is een bekende Flutter-platformbeperking die wordt bijgehouden in flutter/flutter#185894.

In sommige gevallen vertrouwt ondersteunende technologie op AccessibilityEvent beschrijvingen van het Android-systeem om informatie aan de gebruiker aan te kondigen wanneer er geen andere aankondiging beschikbaar is. Aangezien AccessibilityEvents worden geactiveerd door gebruikersacties, kunnen we geen toegang krijgen tot de juiste beschrijving als deze informatie niet wordt verstrekt.

Om dit probleem te omzeilen, zorgt u ervoor dat alle relevante weergaven als belangrijk voor toegankelijkheid worden gemarkeerd. Dit stelt Talkback in staat de informatie van de weergave te verkrijgen, die onze tool vervolgens kan detecteren.

Onze Kleurcontrast-regel is afhankelijk van Machine Learning om tekst te detecteren, wat ervoor zorgt dat de gescande tekst zichtbaar is voor gebruikers van je applicatie. In gevallen waar de tekst in een weergave dezelfde kleur heeft als de achtergrond, kan ons Machine Learning-algoritme niet vaststellen of er tekst aanwezig is, waardoor de Kleurcontrast-regel niet wordt uitgevoerd op deze weergave.

Apps geschreven met XML die de hinttekstfunctie gebruiken, kunnen valse positieven zien met de EditTextName regel. Hinttekst werd pas geïntroduceerd met Android 8 (SDK 26). Het gebruik van dit element in uw XML-app wijst de hinttekst toe aan de waarde van het tekstinvoerveld. Recentere versies van Android zijn beter uitgerust om deze ervaring toegankelijk te maken.

Om dit probleem te verhelpen, is onze eerste aanbeveling om uw tests op nieuwere versies van Android uit te voeren. Als het echter belangrijk is dat de app toegankelijk is op oudere Android-versies, kunt u overwegen het gebruik van de hintText functie te vermijden, aangezien deze niet officieel wordt ondersteund.

U kunt resultaten zien voor weergaven die verborgen zijn achter andere weergaven op het scherm. Deze verborgen weergaven zijn niet beschikbaar voor ondersteunende technologie, maar Axe DevTools Mobile rapporteert ze nog steeds als problemen.

We werken aan een oplossing voor dit complexe probleem. In de tussentijd, als TalkBack geen toegang heeft tot deze weergaven, kunt u de bijbehorende problemen negeren. Ze vereisen geen oplossing om de toegankelijkheid te garanderen.

ML Kit-tekstherkenning is vereist in vele regels van de Axe DevTools Mobile om de nauwkeurigheid van resultaten te waarborgen. De ML Kit-bibliotheek moet automatisch worden geïmporteerd bij het verwijzen naar Axe DevTools Mobile in uw geautomatiseerde Espresso- of UIAutomator-tests. In sommige gevallen echter vindt de automatische import niet plaats en ziet u de volgende foutmelding in de logcat:

De Touch Target Afstandsregel draait momenteel niet op schuifregelaarcomponenten die in Jetpack Compose zijn geschreven. Er kan momenteel geen actie worden ondernomen. Er komt echter snel een oplossing!

Op Android API 30 heeft een van de locaties waarop we proberen resultaten lokaal op te slaan een permissiefout. Het resultaat zal nog steeds worden opgeslagen als een JSON-bestand, ondanks dat deze fout wordt weergegeven. De fout kan worden onderdrukt door de code in het volgende blok uit te commentariëren:

In sommige hybride en cross-platform apps kunnen we onverwachte resultaten teruggeven wanneer items in een scrollweergave gedeeltelijk buiten beeld zijn. Om een element op toegankelijkheid te testen, zorg ervoor dat het volledig in beeld is voordat u de scan uitvoert.

Met de introductie van API 31 (Android 12) komt de mogelijkheid om niet-systeem-overlays te verbergen. Om de Axe Analyzer-app te gebruiken, zorgt u ervoor dat deze instelling niet is ingeschakeld. Als u ervoor heeft gekozen deze functie te gebruiken voor de beveiligingsverbeteringen, raden wij aan deze uit te laten voor interne testversies waar u testgegevens veilig kunt gebruiken en zo beveiligingsproblemen kunt elimineren. Note: this setting does not affect Google's accessibility scanner app as it's considered a system overlay.

Om de Axe Accessibility Analyzer-app te gebruiken, werkt u alle oproepen naar de methode setHideOverlayWindows(true) bij op de getroffen activiteitvensters. setHideOverlayWindows(false) bij op de getroffen activiteitvensters.

Om de volledige functionaliteit van Axe DevTools voor Mobiel te ontgrendelen, zorgt u ervoor dat screenshots zijn ingeschakeld. We raden aan om screenshots in te schakelen op een debug- of testversie van uw app die gebruikmaakt van gesimuleerde gegevens om beveiligingsproblemen te voorkomen. Bekijk onze gids voor screenshots inschakelen in Android-apps.

Als je je build minimaliseert, zul je een crash zien met een foutrapport waarin staat dat een adapter niet gevonden kon worden bij het inloggen op de Axe DevTools-bibliotheek. Schakel minimaliseren uit voor je debug builds met Axe DevTools geïmplementeerd. (#729)

Een build met r8 ingeschakeld kan proberen de axeDevTools-bibliotheek te minimaliseren, wat resulteert in een foutmelding vergelijkbaar met:

De Compose-API's zijn verouderd, gebruik alstublieft de layout-agnostische API's om updates te blijven ontvangen. Als je de Compose-API's blijft gebruiken en een fout tegenkomt zoals `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` of `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, raadpleeg dan Compose setTestTag API.

Door beperkingen van de MAUI-apparchitectuur in het Android-ecosysteem, zal de Bewerking Tekst Naam Regel als 'Moet worden beoordeeld' in het dashboard verschijnen wanneer een mislukking wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig het correcte gedrag handmatig in dit geval.

Wanneer je aangepaste dialogen of modalen implementeert die de native controls niet uitbreiden, kun je resultaten krijgen voor views achter het modal. In dit geval raden we aan onze tool niet te gebruiken tegen deze aangepaste modalen of dialogen, maar deze handmatig te controleren om ervoor te zorgen dat ze correct werken met ondersteunende technologieën.

Als de screenshot ontbreekt op de scangegevenspagina, kan het zijn dat je app het maken van screenshots verhindert. Vaak is dit om veiligheidsredenen in je productieapplicatie. Overweeg om deze vereiste te verwijderen voor je testbuild om volledige functionaliteit mogelijk te maken in het Axe DevTools Mobile Dashboard.

• Android - FLAG_SECURE

Sommige Android-scan namen die standaard op de schermtitel zijn ingesteld, zullen verschijnen als de volledige klassennaam, inclusief de bundelidentifier. In een toekomstige release zal dit worden opgelost zodat de schermtitel wordt omgezet in een beter leesbare naam. Als tijdelijke oplossing kun je de scan naam instellen vanuit het dashboard of frameworks. (#1643)