Axe DevTools Mobile release-opmerkingen 22 april 2026

Bij het uitvoeren van toegankelijkheidscontroles op kleinere schermformaten of met kleinere lettergroottes kan de Kleurcontrast-regel false positives rapporteren voor verloopachtergronden. In dergelijke gevallen kan het zijn dat de voorgrondkleur niet kan worden bepaald en in plaats daarvan achtergrondkleuren met elkaar worden vergeleken, wat resulteert in een fout.

Om dit probleem te omzeilen, probeer toegankelijkheidscontroles uit te voeren op grotere apparaten. U kunt er ook voor kiezen de regel in uw tests te negeren en kleurcontrast handmatig voor deze weergaven te controleren.

De toegankelijkheids-API's van Apple rapporteren mogelijk onterecht webinhoud binnen WKWebView 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 stappenknoppen niet "gedimd" worden aangekondigd door hulpaandrijving om aan te geven dat ze niet zijn ingeschakeld. Hierdoor 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 op niet-ingeschakelde stappenknoppen: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze bug verhelpt, zal de oplossing zijn om [de regels te negeren](ios-ignore-rule). De standaard stappenknoppen hebben de identifiers "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.

Sommige schermen kunnen false positives rapporteren met LabelInName en LabelAtFront vanwege een incorrect gevonden associatedText-eigenschap (#1622)

Er is een probleem dat de iPhone 15 Pro-simulator beïnvloedt en voorkomt dat de Ondersteuning voor Dynamische Types-regel werkt. Als u bent aangemeld voor de Ondersteuning voor Dynamische Types-regel, kunt u deze niet testen met een iPhone 15 Pro-simulator. Er is een bug gemeld bij Apple.

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

In UIKit-apps is een afbeelding zonder een `accessibilityLabel` standaard niet focusbaar met ondersteunende technologie.
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 Naamproblemen in UIKit-apps worden gerapporteerd als Moet Beoordeeld Worden. Er is een bugrapport ingediend bij Apple. (#1633)

We werken actief aan oplossingen voor de volgende false positives en zullen deze lijst bijwerken zodra er oplossingen zijn uitgebracht.

In Scroll View
Tekst binnen elementen die zich als een banner gedragen, kan mogelijk worden gemarkeerd met een "Moet Beoordeeld Worden"-bericht. 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 bedieningselementen die erin genest zijn, kan ActiveControlName een false positive melden 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 het zichtbare label van een bedieningselement tussen nabije elementen om de regelstatus te bepalen. In sommige weergave-hiërarchieën kan de verkeerde nabije tekst worden gedetecteerd, waardoor deze regels falen. (#1622)

In sommige gevallen vertrouwt ondersteunende technologie op AccessibilityEvent beschrijvingen van het Android-systeem om informatie aan de gebruiker te melden wanneer er geen andere aankondiging beschikbaar is. Omdat AccessibilityEvents are triggered by user actions, we are unable to access the correct description if this information is not provided.

Om dit probleem te voorkomen, zorg ervoor dat alle relevante weergaven als belangrijk voor toegankelijkheid zijn gemarkeerd. Hierdoor kan Talkback de informatie van de weergave verkrijgen, die ons hulpmiddel vervolgens kan detecteren.

Onze Kleurencontrastregel maakt gebruik 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 binnen een weergave dezelfde kleur heeft als de achtergrond, kan ons Machine Learning-algoritme niet detecteren of er tekst aanwezig is, dus de Kleurencontrastregel wordt niet uitgevoerd op deze weergave.

Apps geschreven met XML die de functie voor hinttekst gebruiken, kunnen false positives ervaren 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 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 deze weergaven niet kan bereiken, kunt u de bijbehorende problemen negeren. Ze vereisen geen oplossing om toegankelijkheid te garanderen.

ML Kit tekstdetectie is vereist in veel van de axe DevTools Mobile-regels om nauwkeurigheid van resultaten te garanderen. De ML Kit-bibliotheek zou automatisch moeten worden geïmporteerd bij het verwijzen 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:

Axe DevTools Android: Error while running mlKit Text Detection: MlKitContext has not been initialized.

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

debugImplementation 'com.google.mlkit:text-recognition:16.0.1'

De Touch Target-afstandsregel wordt momenteel niet uitgevoerd op schuifregelaarcomponenten die in Jetpack Compose 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 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'

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

Met API 31 (Android 12) is de mogelijkheid geïntroduceerd om niet-systeem overlays te verbergen. Om de axe Analyzer-app te gebruiken, zorg ervoor dat deze instelling niet is ingeschakeld. Als u ervoor gekozen heeft om deze functie te gebruiken vanwege zijn beveiligingsverbeteringen, raden we aan deze uit te laten voor interne testversies, waar u veilig testgegevens kunt gebruiken en beveiligingsproblemen daardoor 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 eventuele aanroepen naar de methode setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de getroffen activiteitenvensters.

Om de volledige functionaliteit van axe DevTools voor Mobile 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 gesimuleerde gegevens om beveiligingsproblemen te voorkomen. Bekijk onze gids voor schermafbeeldingen inschakelen in Android-apps.

Als u uw build minimaliseert, krijgt u een crash met een foutmelding die aangeeft dat een adapter niet kan 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 r8 ingeschakeld kan proberen de axeDevTools-bibliotheek te minimaliseren, wat resulteert in een foutmelding 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)
	

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

Vanwege beperkingen van de MAUI-apparchitectuur binnen het Android-ecosysteem, zal de regel voor bewerken van de tekstnaam worden weergegeven als Vereist Beoordeling in het dashboard wanneer een fout wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig alstublieft handmatig het correcte gedrag voor dit geval.

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

Als de screenshot ontbreekt op de scangedetailpagina, kan het zijn dat uw app het maken van screenshots verhindert. Dit is vaak om beveiligingsredenen in uw productieapplicatie. Overweeg deze eis te verwijderen voor uw testbuild om volledige functionaliteit in het axe DevTools Mobile-dashboard mogelijk te maken.

• Android - FLAG_SECURE

Sommige Android-scan namen die standaard de schermtitel aannemen, zullen verschijnen als de volledige klassennaam inclusief de bundelidentifier. In een toekomstige release zal dit worden opgelost zodat de schermtitel wordt opgemaakt tot een beter leesbare naam. Als oplossing kunt u de scannaam instellen vanuit het dashboard of frameworks. (#1643)