axe DevTools Mobile Release-opmerkingen van 6 november 2025

Apple's toegankelijkheids-API's kunnen onjuist webinhoud binnen WKWebView rapporteren als „isVisible“, zelfs wanneer de webview bedekt is door native overlays (zoals modale vensters, meldingen 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 ongehinderd en waarneembaar is voor de gebruiker.

iOS 26 bevat een toegankelijkheidsbug waarbij standaard stapknoppen niet "gedimd" aankondigen via hulpmiddelen om aan te geven dat ze niet ingeschakeld zijn. Als gevolg daarvan ziet 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 stapknoppen: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze bug oplost, is de oplossing om [de regels te negeren](ios-ignore-rule). De standaard stapknoppen hebben de identificatoren "Decrement" en "Increment", en kunnen indien nodig per identificator 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 voorkomt dat scans worden uitgevoerd en geeft het bericht "Test mislukt" terug. Om scans op een fysiek apparaat uit te voeren, update naar het nieuwste iOS Analyzer-project.

Functionaliteit bij het testen van een toepassing met de bundle identifier was kapot 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 toepassingen met deze versie van de analyzer en SDK zou resulteren in een "Could not Serialize AxeResult" fout. Update naar de nieuwste versie om de fout op te lossen. Update naar het nieuwste iOS Analyzer-project.Update naar de nieuwste iOS SDK.

Sommige schermen kunnen false positives melden met LabelInName en LabelAtFront door een onjuiste associatedText-eigenschap die is gevonden (#1622)

Er is een probleem dat de iPhone 15 Pro-simulator beïnvloedt en voorkomt dat de regel ter ondersteuning van Dynamische Type wordt uitgevoerd. Als je bent ingeschreven voor de regel ter ondersteuning van Dynamische Type, kun je deze niet testen met een iPhone 15 Pro-simulator. Er is een bug ingediend bij Apple.

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

In UIKit-toepassingen is een afbeelding zonder een accessibilityLabel standaard niet focusbaar met ondersteunende technologieën.
De eigenschappen die we gebruiken om de 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 'Moet beoordeeld worden'. Er is een bugrapport ingediend bij Apple. (#1633)

We werken actief aan oplossingen voor de volgende fout-positieve resultaten en zullen deze lijst bijwerken zodra oplossingen worden uitgebracht.

In Scroll View
Kan problemen rapporteren voor tekst binnen elementen met banner-gedrag. 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 erbinnen genest, kan ActiveControlName een fout-positief rapporteren op 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 een zichtbare label van een besturingselement tussen nabijgelegen elementen om de status van de regel te bepalen. In sommige weergavehiërarchieën kan de verkeerde nabijgelegen tekst worden gedetecteerd, 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 uw applicatie. In gevallen waar de tekst die in een weergave wordt weergegeven dezelfde kleur heeft als de achtergrond, kan ons Machine Learning-algoritme niet detecteren of er tekst aanwezig is, zodat de kleurcontrastregel niet wordt uitgevoerd op deze weergave.

Apps geschreven in XML die gebruikmaken van de hinttekstfunctie kunnen fout-positieven zien bij 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. Meer recente versies van Android zijn beter uitgerust om deze ervaring toegankelijk te maken.

Om dit probleem te overwinnen, is onze eerste aanbeveling om uw tests uit te voeren op nieuwere versies van Android. Als het belangrijk is dat de app toegankelijk is op oudere Android-versies, kunt u overwegen om het gebruik van het hintText kenmerk te vermijden, aangezien het 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 deze weergaven niet kan bereiken, kunt u 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 garanderen. De ML Kit-bibliotheek moet automatisch worden geïmporteerd wanneer u verwijst naar axe DevTools Mobile in uw geautomatiseerde Espresso- of UIAutomator-tests. In sommige gevallen gebeurt de automatische import echter niet en ziet u de volgende fout in de logcat:

Om dit probleem op te lossen, moet u de ML Kit-bibliotheek handmatig in uw project importeren. In uw applicatie's build.gradle bestand, voegt u het volgende toe onder dependencies:

De aanraakdoel-afstandsregel wordt momenteel niet uitgevoerd op schuifregelaars die in Jetpack Compositie zijn geschreven. Er kan op dit moment 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 machtigingsfout. Het resultaat wordt nog steeds opgeslagen als een JSON-bestand, ondanks dat deze fout wordt weergegeven. De fout kan onderdrukt worden door de code in het volgende blok uit te schakelen:
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 moet worden uitgeschakeld voor API 30, omdat dit problemen zal veroorzaken bij het lokaal opslaan voor andere API-niveaus.

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

Geïntroduceerd met API 31 (Android 12) is de mogelijkheid om niet-systeemoverlays te verbergen. Om de axe Analyzer-app te gebruiken, moet u ervoor zorgen dat deze instelling niet is ingeschakeld. Als u ervoor hebt gekozen om deze functie te gebruiken vanwege de verbeteringen op het gebied van beveiliging, raden we aan deze uit te schakelen voor interne testversies waar u op veilige wijze testgegevens kunt gebruiken en beveiligingsrisico's op die manier kunt elimineren. Note: this setting does not affect Google's accessibility scanner app as it's considered a system overlay.

Om de axe Toegankelijkheid Analyzer app te gebruiken, update alle aanroepen naar de methode setHideOverlayWindows(true) tot setHideOverlayWindows(false) op de getroffen activiteitenvensters.

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

Als u uw build minimaliseert, ziet u een crash met een foutlog dat meldt dat een adapter niet kon worden gevonden bij het proberen in te loggen op de axe DevTools-bibliotheek. Schakel minimalisatie uit voor uw debug-builds met geïmplementeerde axe DevTools. (#729)

Een build met ingeschakelde r8 kan proberen de axeDevTools-bibliotheek te minimaliseren, wat resulteert in een fout zoals:
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, voegt u de volgende regel toe aan uw ProGuard-bestand om axeDevTools-klassen te behouden:
keep class com.deque.** { *; }

De Compose API's zijn verouderd, gebruik de lay-out onafhankelijke API's om updates te blijven ontvangen. Als u de Compose API's blijft gebruiken en een fout tegenkomt zoals `Exact '1' knoop verwacht maar '2' knopen gevonden die voldoen aan: (isRoot)` of `Geen View geïnitialiseerd, heeft u AxeDevToolsCompose.setComposeTestRule() aangeroepen?`, raadpleeg dan Compose setTestTag API.

Als u dit bericht tegenkomt, kunnen sommige regelresultaten mogelijk niet als verwacht terugkeren wanneer die regel kunstmatige intelligentie gebruikt. Betrokken regels zijn onder meer Kleurencontrast, Focusbare Tekst en Geneste Elementnaam. (#841)

Vanwege beperkingen in de rendering van de MAUI-app-architectuur in het Android-ecosysteem, zal de regel Bewerken Tekstnaam als Beoordeling Nodig worden weergegeven in het dashboard wanneer er een mislukking wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig in dit geval handmatig het correcte gedrag.

Wanneer u aangepaste dialogen of modalen implementeert die de native controls niet uitbreiden, kunt u resultaten krijgen voor weergaven achter het modaal. In dit geval raden we aan om onze tool niet tegen deze aangepaste modalen of dialogen te draaien en in plaats daarvan ze handmatig te controleren om ervoor te zorgen dat ze naar wens werken met ondersteunende technologie.

Als de screenshot ontbreekt op de scansdetailpagina, kan uw app voorkomen dat er screenshots worden gemaakt. Vaak is dit om veiligheidsredenen in uw productieapplicatie. Overweeg om deze vereiste te verwijderen voor uw testbuild om volledige functionaliteit mogelijk te maken in het axe DevTools Mobile Dashboard.

• Android - FLAG_SECURE

Sommige Android-scan namen die standaard de schermtitel als naam hebben, zullen worden weergegeven als de volledige klassennaam inclusief de bundelidentifier. In een toekomstige release zal dit opgelost worden zodat de schermtitel wordt geformatteerd tot een leesbaardere naam. Als tijdelijke oplossing kunt u de scan naam instellen vanuit het dashboard of frameworks. (#1643)