axe DevTools Mobile Release Notes 26 november 2025

De toegankelijkheids-API's van Apple kunnen webinhoud binnen WKWebView onterecht rapporteren als „isVisible”, zelfs wanneer de webview bedekt is door native overlays (zoals modale weergaven, 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 onbelemmerd en waarneembaar is voor de gebruiker.

iOS 26 bevat een toegankelijkheidsbug waarbij standaard stepper-knoppen niet „gedimd“ worden aangegeven door ondersteunende technologieën om aan te geven dat ze niet zijn ingeschakeld. 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 op uitgeschakelde stepper-knoppen rapporteren: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze bug oplost, is de oplossing om [de regels te negeren](ios-ignore-rule). De standaard stepper-knoppen hebben de identificaties „Decrement“ en „Increment“, en kunnen indien nodig op identifier worden genegeerd.

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.

Een configuratie-instelling in de iOS Analyzer 1.4.7 verhindert dat scans worden uitgevoerd, met de mededeling „Test mislukt“. Om scans op een fysiek apparaat uit te voeren, update naar het nieuwste iOS Analyzer-project.

Functionaliteit voor het testen van een applicatie op bundelidentifier was gebroken in versie 2.8.1 wat resulteerde in een fout met de titel "No target application path specified via test configuration: ...". Update naar 2.8.2 of de nieuwste versie om de fout op te lossen. Update naar de nieuwste binnen het iOS Analyzer-project.

Het scannen van sommige applicaties met deze versie van de analyzer en SDK zou resulteren in een "Could not Serialize AxeResult" fout. Werk bij naar de nieuwste versie om de fout te verhelpen. Werk bij naar de nieuwste iOS Analyzer-project.Werk bij naar de nieuwste iOS SDK.

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

Er is een probleem met de iPhone 15 Pro-simulator waardoor de Ondersteunt Dynamic Type-regel niet werkt. Als je je hebt aangemeld voor de Ondersteunt Dynamic Type-regel, kun je deze niet testen met behulp van een iPhone 15 Pro-simulator. Er is een bug ingediend bij Apple.

Bij het zoeken naar 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 focusbaar met assistentechnologie.
De eigenschappen die we gebruiken om focusbaarheid van Apple te controleren kunnen onnauwkeurig zijn wanneer een accessibilityIdentifier is ingesteld op de afbeelding. Vanwege dit onverwachte gedrag zullen resultaten voor ImageView Naam problemen in UIKit-apps rapporteren als Behoefte aan Herziening. Er is een bugrapport ingediend bij Apple. (#1633)

We werken actief aan oplossingen voor de volgende valse positieven en zullen deze lijst bijwerken zodra er oplossingen worden vrijgegeven.

In Scroll View
Kan problemen melden voor tekst binnen banner-gedrag elementen. Om deze elementen beschikbaar te maken voor degenen die grotere tekst nodig hebben, gebruik UILargeContentViewer. (#622)

v2.11.0 Image View Name & Active Control Name
Als een UIImageView een accessibilityIdentifier heeft ingesteld maar niet focusbaar is door VoiceOver, en het heeft focusbare besturingselementen erin genest, kan ActiveControlName een vals positief rapporteren over de UIImageView. Het verwijderen van de accessibilityIdentifier lost het probleem op. Er is een bug ingediend bij Apple. (#1633)

Label In Name and Label At Front
Deze twee regels zoeken naar het zichtbare label van een besturingselement tussen naburige elementen om de status van de regels te bepalen. In sommige weergave-hiërarchieën kan de verkeerde naburige tekst gedetecteerd worden waardoor deze regels falen. (#1622)

Onze kleurcontrastregel 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 die in een weergave is opgenomen dezelfde kleur heeft als de achtergrond, is ons machine learning-algoritme niet in staat om te detecteren of er tekst aanwezig is, zodat de kleurcontrastregel niet wordt uitgevoerd op deze weergave.

Apps geschreven met XML die de hint-tekstfunctie gebruiken kunnen valse positieven zien met de EditTextName regel. Hint-tekst werd niet geïntroduceerd tot Android 8 (SDK 26). Het gebruik van dit element in je XML-app zal de hint-tekst toekennen aan de waarde van het tekstinvoerveld. Recentere versies van Android zijn beter uitgerust om deze ervaring toegankelijk te maken.

Om dit probleem te overwinnen, is onze eerste aanbeveling om je tests op nieuwere versies van Android uit te voeren. Als het belangrijk is dat de app toegankelijk is op eerdere Android-versies, kun je overwegen om het gebruik van de hintText functie te vermijden, aangezien deze niet officieel wordt ondersteund.

Je kunt resultaten zien voor weergaven die verborgen zijn achter andere weergaven op het scherm. Deze verborgen weergaven zijn niet beschikbaar voor assisstentechnologie, maar axe DevTools Mobile meldt ze nog steeds als problemen.

We werken aan een oplossing voor dit complexe probleem. Ondertussen, als TalkBack deze weergaven niet kan bereiken, kun je de bijbehorende problemen negeren. Ze vereisen geen oplossing om toegankelijkheid te garanderen.

ML Kit tekstherkenning is vereist in veel van de axe DevTools Mobile-regels om de nauwkeurigheid van resultaten te waarborgen. De ML Kit-bibliotheek zou automatisch moeten worden geïmporteerd wanneer je naar axe DevTools Mobile verwijst in je geautomatiseerde Espresso- of UIAutomator-tests. In sommige gevallen gebeurt de automatische import echter niet en zie je de volgende fout in de logcat:

Om dit probleem te overwinnen, moet je de ML Kit-bibliotheek handmatig in je project importeren. In het build.gradle bestand van je applicatie, voeg het volgende toe onder dependencies:

De Touch Target-afstandsregel wordt momenteel niet uitgevoerd op schuifregelaarcomponenten die zijn geschreven in Jetpack Compose. Op dit moment kan er geen actie worden ondernomen. Er komt echter binnenkort een oplossing!

Op Android API 30, heeft een van de locaties waar we proberen resultaten lokaal op te slaan een toestemmingsfout. Het resultaat wordt nog steeds opgeslagen als een JSON-bestand, ondanks dat deze fout wordt weergegeven. De fout kan onderdrukt worden door de code uit te schakelen in het volgende blok:
def clearDirectoryTask = task('clearDirectoryTask', type: Exec, group: 'reporting') {
executable "${android.getAdbExecutable().toString()}"
args 'shell', 'rm', '-r', '/storage/emulated/0/Documents/AxeTestCases'
// finalizedBy {
// fetchAndroidFolderAxeReportsTask
// }
}

Houd er rekening mee dat deze code alleen mag worden uitgeschakeld voor API 30, omdat dit problemen zal veroorzaken bij het lokaal opslaan voor andere API-niveaus.

In sommige hybride en cross-platform apps kunnen we onverwachte resultaten retourneren wanneer items in een scrollweergave deels buiten het scherm liggen. Om een element te testen op toegankelijkheid, zorg ervoor dat het volledig op het scherm staat voordat je de scan uitvoert.

Met API 31 (Android 12) is de mogelijkheid geïntroduceerd om niet-systeemoverlays te verbergen. Om de axe Analyzer-app te gebruiken, zorg ervoor dat deze instelling niet is ingeschakeld. Als je ervoor hebt gekozen om deze functie te gebruiken vanwege de beveiligingsverbeteringen, raden we aan deze uitgeschakeld te laten voor interne testversies waarin je veilig testgegevens 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, update je alle oproepen naar de methode setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de betreffende activiteitvensters.

Om de volledige functionaliteit van axe DevTools voor Mobile te ontgrendelen, zorg ervoor dat screenshots zijn ingeschakeld. We raden aan om screenshots in te schakelen in een debug- of testversie van je app die gebruikmaakt van gesimuleerde gegevens om beveiligingsproblemen te vermijden. Bekijk onze gids voor het inschakelen van screenshots in Android-apps.

Als je je build minimaliseert, krijg je een crash met een foutmelding dat een adapter niet kan worden gevonden wanneer je probeert in te loggen in de axe DevTools-bibliotheek. Schakel het minimaliseren van je debug-builds met geïmplementeerde axe DevTools uit. (#729)

Een build met r8 ingeschakeld kan proberen de axeDevTools-bibliotheek te minimaliseren, wat resulteert in een foutmelding die lijkt op:
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)
Om deze fout op te lossen, voeg de volgende regel toe aan je ProGuard-bestand om axeDevTools-klassen te behouden:
keep class com.deque.** { *; }

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

Als je dit bericht tegenkomt, kunnen sommige regelresultaten niet zoals verwacht worden geretourneerd wanneer die regel gebruikmaakt van kunstmatige intelligentie. Betreffende regels zijn onder andere Kleurencontrast, Focusbare Tekst en Geneste Elementnaam. (#841)

Vanwege beperkingen van de MAUI-apparchitectuur die in het Android-ecosysteem wordt gerenderd, wordt de regel voor het bewerken van tekstnamen op het dashboard weergegeven als Moet worden beoordeeld wanneer een fout wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig het juiste gedrag handmatig voor dit geval.

Wanneer je aangepaste dialogen of modals implementeert die de native controls niet uitbreiden, kun je resultaten krijgen voor weergaven achter de modal. In dit geval raden we aan onze tool niet tegen deze aangepaste modals of dialogen te gebruiken en in plaats daarvan deze handmatig te controleren om ervoor te zorgen dat ze werken met ondersteunende technologie zoals gewenst.

Als de screenshot ontbreekt op de pagina met scantdetails, kan het zijn dat je app voorkomt dat er screenshots worden gemaakt. Dit is vaak om veiligheidsredenen in je productie-applicatie. 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 standaard Android-scannamen die zijn ingesteld op de schermtitel zullen verschijnen als de volledige klassennaam inclusief de bundelidentificatie. In een toekomstige release zal dit worden opgelost zodat de schermtitel wordt opgemaakt tot een leesbaardere naam. Als tijdelijke oplossing kun je de scannaam instellen vanuit het dashboard of frameworks. (#1643)