Axe DevTools Mobile Release-opmerkingen van 10 december 2025

Bij het uitvoeren van toegankelijkheidscontroles op kleinere schermgroottes of met kleinere lettergroottes, kan de Kleurcontrastregel valse positieven rapporteren voor gradiëntachtergronden. In dergelijke gevallen kan het de voorgrondkleur mogelijk niet bepalen en in plaats daarvan achtergrondkleuren met elkaar vergelijken, wat tot een fout leidt.

Om dit probleem te omzeilen, probeer toegankelijkheidscontroles uit te voeren op grotere apparaten. Als alternatief kunt u ervoor kiezen de regel in uw tests te negeren en de Kleurcontrast handmatig voor deze weergaven te controleren.

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

iOS 26 bevat een toegankelijkheidsbug waarbij standaard stepper-knoppen niet worden aangekondigd als „gedimd“ door Hulpmiddelen voor Toegang om aan te geven dat ze niet ingeschakeld zijn. Als gevolg hiervan zien ook de iOS-regels deze knoppen 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 op uitgeschakelde stepper-knoppen: AssociatedText, InaccessibleAction, en ColorContrast.

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

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 gevonden associatedText-eigenschap (#1622)

Er is een probleem dat de iPhone 15 Pro-simulator treft waardoor de Support voor Dynamic Type-regel niet wordt uitgevoerd. Als u bent aangemeld voor de Support voor Dynamic Type-regel, kunt u deze niet testen met een iPhone 15 Pro-simulator. Er is een bugrapport ingediend bij Apple.

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

In UIKit-apps is een afbeelding zonder een accessibilityLabel standaard niet focusbaar met hulpmiddelen voor toegang.
De eigenschappen die we gebruiken om focusbaarheid te controleren van Apple kunnen onnauwkeurig zijn wanneer een accessibilityIdentifier is ingesteld op de afbeelding. Vanwege dit onverwachte gedrag zullen resultaten voor ImageView Naam-problemen in UIKit-apps worden gerapporteerd als Moet Beoordeeld Worden. 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 er oplossingen beschikbaar zijn.

In Scroll View
Kan problemen melden voor tekst binnen banieren-gedragende 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 ingesteld heeft maar niet focusbaar is met VoiceOver, en daarin geneste focusbare controles aanwezig zijn, kan ActiveControlName een vals positief resultaat melden op de UIImageView. Het verwijderen van de accessibilityIdentifier lost het probleem op. Er is een bugrapport ingediend bij Apple. (#1633)

Label In Name and Label At Front
Deze twee regels zoeken naar de zichtbare label van een controle onder nabijgelegen elementen om de status van de regel te bepalen. In sommige weergavehiërarchieën kan het onjuiste naburige tekst gedetecteerd worden, waardoor deze regels mislukken. (#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 waarin de tekst in een weergave dezelfde kleur heeft als de achtergrond, kan ons Machine Learning-algoritme niet detecteren of er überhaupt tekst aanwezig is, waardoor de Kleurcontrastregel niet wordt uitgevoerd op deze weergave.

Apps geschreven met XML die gebruikmaken van de hinttekstfunctie kunnen valse positieven zien met de EditTextName regel. Hinttekst werd pas geïntroduceerd in Android 8 (SDK 26). Het gebruik van dit element in uw XML-app zal de hinttekst toewijzen 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 op nieuwere versies van Android uit te voeren. Als het echter belangrijk is dat de app toegankelijk is op eerdere Android-versies, kunt u overwegen om het gebruik van de hintText functie te vermijden, aangezien deze officieel niet wordt ondersteund.

U kunt resultaten zien voor weergaven die verborgen zijn achter andere weergaven op het scherm. Deze verborgen weergaven zijn niet beschikbaar voor hulptechnologie, 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 de toegankelijkheid te waarborgen.

Tekstdetectie met ML Kit is vereist in veel van de regels van axe DevTools Mobile om de nauwkeurigheid van de resultaten te garanderen. De ML Kit-bibliotheek zou automatisch moeten 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 foutmelding in de logcat:

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

De Touch Target-afstandsregel wordt momenteel niet uitgevoerd op schuifcomponenten die in Jetpack Compose zijn geschreven. Op dit moment kunnen geen acties 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. Ondanks dat deze fout wordt weergegeven, wordt het resultaat toch als een JSON-bestand opgeslagen. De fout kan worden onderdrukt door de code in het volgende blok uit te commentariëren:
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 voor API 30 moet worden uitgecommentarieerd, omdat dit problemen zal veroorzaken bij het lokaal opslaan voor andere API-niveaus.

In sommige hybride en cross-platform apps kunnen we onverwachte resultaten teruggeven wanneer items in een scrollweergave gedeeltelijk van het scherm zijn. Om een element op toegankelijkheid te testen, zorg ervoor dat het volledig op het scherm 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, zorg ervoor dat deze instelling is uitgeschakeld. Als u ervoor heeft gekozen om deze functie vanwege de beveiligingsverbeteringen te gebruiken, raden we aan om deze uit te laten voor interne testversies, waar u veilig testgegevens kunt gebruiken en beveiligingsproblemen op die manier kunt uitsluiten. 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, werk alle aanroepen naar de methode setHideOverlayWindows(true) bij op de betreffende activiteitvensters. setHideOverlayWindows(false)

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

Als u uw build minimaliseert, krijgt u een crash met een foutlog dat meldt dat een adapter niet kon worden gevonden bij het inloggen op de axe DevTools-bibliotheek. Schakel het minimaliseren van uw debug-builds uit waarin axe DevTools is geïmplementeerd. (#729)

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

De Compose-API's zijn verouderd, gebruik de layout-agnostische API's om updates te blijven ontvangen. Als u 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.

Als u dit bericht tegenkomt, kunnen sommige regelresultaten niet zoals verwacht terugkeren wanneer die regel kunstmatige intelligentie gebruikt. Getroffen regels zijn onder andere Kleurencontrast, Focusbare tekst en Geneste elementennaam. (#841)

Vanwege beperkingen van de MAUI-apparchitectuur in het Android-ecosysteem, wordt de Edit Text Name-regel weergegeven als Herziening nodig in het dashboard wanneer een mislukking wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig in dit geval het correcte gedrag handmatig.

Wanneer u aangepaste dialogen of modals implementeert die de native controles niet uitbreiden, kunt u resultaten krijgen voor weergaven achter de modal. In dit geval raden we aan onze tool niet tegen deze aangepaste modals of dialogen te gebruiken, maar ze in plaats daarvan handmatig te controleren om ervoor te zorgen dat ze zich met hulpmiddelen naar wens gedragen.

Als de screenshot ontbreekt op de details-pagina van de scan, kan uw app voorkomen dat screenshots worden gemaakt. Vaak is dit om beveiligingsredenen in uw productieapplicatie. Overweeg om deze vereiste te verwijderen voor uw testversie om volledige functionaliteit in het axe DevTools Mobile Dashboard mogelijk te maken.

• Android - FLAG_SECURE

Sommige Android-scan-namen die standaard op de schermtitel zijn ingesteld, worden weergegeven als de volledige class-naam inclusief de bundelidentifier. In een toekomstige release zal dit worden opgelost zodat de schermtitel wordt opgemaakt tot een meer leesbare naam. Als tijdelijke oplossing kunt u de scan-naam instellen vanuit het dashboard of frameworks. (#1643)