Axe DevTools Mobile Release-opmerkingen 30 juni 2026

De Kleurcontrastregel gebruikt Apple's Vision-framework (Optical Character Recognition, of OCR) om tekst binnen de grenzen van een element te lezen. OCR kan soms kleine icoonachtige glyphs - zoals pijlterug-chevron (<), opsommingstekens, decoratieve symbolen - ten onrechte als tekst identificeren. Wanneer dat gebeurt, voert de Kleurcontrastregel een controle uit op een element dat geen leesbare tekst bevat, wat kan resulteren in een resultaat voor een knop met alleen icoon. Omdat de OCR-uitvoer niet deterministisch is over scans heen, kan hetzelfde element in de Kleurcontrastresultaten verschijnen in de ene scan en als "NIET VAN TOEPASSING" worden gerapporteerd in de volgende. Dit is een bekend kenmerk van OCR, en geen fout in de regel.

Om dit probleem te omzeilen, kun je de ignore API's gebruiken om Kleurcontrastresultaten voor de getroffen elementen te onderdrukken.

// Ignore Color Contrast for a specific element by accessibility identifier
axeDevTools?.configuration.ignore(rulesFor: [
    "backButton": [AxeRuleId.ColorContrast.toString()]
])

Flutter map niet AppBar.title naar de native screen title-eigenschap - UIViewController.title, waardoor de Schermtitelregel op alle Flutter-schermen faalt, ongeacht of er een beschrijvende titel aanwezig is.

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

Wanneer toegankelijkheidscontroles worden uitgevoerd op kleinere schermgroottes of met kleinere lettergroottes, kan de Kleurcontrastregel valse positieven rapporteren voor gradiëntachtergronden. In dergelijke gevallen is het mogelijk dat de voorgrondkleur niet kan worden bepaald en in plaats daarvan achtergrondkleuren met elkaar worden vergeleken, wat resulteert in een mislukking.

Om dit probleem te omzeilen, probeer toegankelijkheidscontroles uitvoeren op grotere apparaten. Als alternatief kun je ervoor kiezen om de regel in je tests te negeren en de Kleurcontrast handmatig voor deze weergaven te controleren.

Apple's toegankelijkheidstools kunnen webinhoud binnen WKWebView ten onrechte rapporteren als "isVisible", zelfs wanneer het webview wordt bedekt 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 onbelemmerd is en waarneembaar voor de gebruiker.

iOS 26 bevat een toegankelijkheidsbug waarbij standaard stapknoppen niet "gedimd" aankondigen via Assistentietechnologie 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 op uitgeschakelde stapknoppen rapporteren: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze bug oplost, is de oplossing om [de regels te negeren](ios-ignore-rule). De standaard stappenknoppen hebben de identificaties „Decrement“ en „Increment“ en kunnen indien nodig op basis van de identificatie 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 valse positieven rapporteren met LabelInName en LabelAtFront vanwege een onjuist associatedText-eigenschap die wordt gevonden (#1622)

Er is een probleem dat de iPhone 15 Pro-simulator treft waardoor de ondersteuning Dynamische Type-regel niet kan worden uitgevoerd. Als u zich heeft aangemeld voor de ondersteuning Dynamische Type-regel, kunt u deze niet testen met een iPhone 15 Pro-simulator. Er is een bug ingediend bij Apple.

Tijdens het zoeken naar een verbetering voor onze regels, hebben we ontdekt dat in XCTest geneste controles niet worden geretourneerd in de toegankelijkheidsstructuur. Er is een bug ingediend bij Apple. (#1110)

In UIKit-apps is een afbeelding zonder een `accessibilityLabel` standaard niet focusbaar met ondersteunende technologie.
De eigenschappen die we gebruiken om fokuseerbaarheid 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 als Herziening Nodig worden gerapporteerd. Er is een bugrapport ingediend bij Apple. (#1633)

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

In Scroll View
Tekst binnen elementen die als banners fungeren, kan worden gemarkeerd met een „Herziening Nodig“-melding. 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 bevat focusbare controles erin genesteld, kan ActiveControlName een vals positief resultaat melden 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 het zichtbare label van een controle tussen nabijgelegen elementen om de status van de regel te helpen bepalen. In sommige weergavehiërarchieën kan onjuiste nabijgelegen tekst worden gedetecteerd, waardoor deze regels mislukken. (#1622)

Wanneer decoratieve tekst in weergaven zoals „Contacticoontjes“ wordt gebruikt, is het mogelijk om een toegankelijkheidsprobleem te introduceren. Als je een tekstweergave gebruikt om letters weer te geven in plaats van afbeeldingen met de gewenste letters als vectoren te genereren, en je vervolgens verklaart dat die tekstweergave niet belangrijk is voor toegankelijkheid, kunnen we niet betrouwbaar vaststellen of je een toegankelijkheidsschending hebt geïntroduceerd.

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

Flutter map niet AppBar.title naar de native schermtitel-eigenschap - Activity.setTitle, waardoor de Schermtitelregel 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 is assistieve technologie afhankelijk van 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 niet op de juiste beschrijving toegang krijgen als deze informatie niet wordt verstrekt.

Om dit probleem te voorkomen, zorg ervoor dat alle relevante weergaven als belangrijk voor toegankelijkheid worden gemarkeerd. Dit zal Talkback in staat stellen de informatie uit de weergave te halen, die ons hulpmiddel vervolgens kan detecteren.

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

Apps geschreven met XML die gebruikmaken van de hinttext-functie, kunnen valse positieven zien met de EditTextName regel. Hinttext werd pas bij Android 8 (SDK 26) geïntroduceerd. Het gebruik van dit element in uw XML-app zal de hinttext toewijzen aan de waarde van het tekstinvoerveld. Nieuwere 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 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 assistieve 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 overeenkomende problemen negeren. Ze vereisen geen oplossing om toegankelijkheid te waarborgen.

ML Kit-teksdetectie is vereist in veel van de axe DevTools Mobile-regels om de nauwkeurigheid van de resultaten te garanderen. 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 vindt de automatische import echter niet plaats 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 in uw project importeren. In het build.gradle bestand van uw applicatie, voeg het volgende toe onder dependencies:

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

De regel voor aanraakdoelafstand wordt momenteel niet uitgevoerd op schuifregelaarcomponenten die zijn geschreven in Jetpack Compose. 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 als een JSON-bestand opgeslagen, 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 terugkrijgen wanneer items in een scroll-view 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, zorg ervoor dat deze instelling niet is ingeschakeld. Als u ervoor heeft gekozen deze functie te benutten vanwege de beveiligingsverbeteringen, raden we aan deze uit te laten voor interne testversies waar u veilig testgegevens kunt gebruiken en beveiligingsproblemen op die manier kunt elimineren. Note: this setting does not affect Google's accessibility scanner app as it's considered a system overlay.

Om gebruik te maken van de axe Accessibility Analyzer-app, update alle aanroepen naar de methode setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de getroffen actieve vensters.

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

Als u uw build minimaliseert, ziet u een crash met een foutlogboek waarin wordt gemeld dat een adapter niet kan worden gevonden wanneer u probeert in te loggen op de axe DevTools-bibliotheek. Schakel het minimaliseren 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 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)
    

De Compose API's zijn verouderd, gebruik alstublieft de layout-agnostische API's om door te gaan met het ontvangen van updates. Als u doorgaat met het gebruiken van de Compose API's 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 alstublieft de Compose setTestTag API.

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

Wanneer u aangepaste dialogen of modals implementeert die niet de native controls 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 en ze in plaats daarvan handmatig te controleren om ervoor te zorgen dat ze correct werken met ondersteunende technologie.

Als de schermafbeelding ontbreekt op de scangegevenspagina, kan het zijn dat uw app verhindert dat er schermafbeeldingen worden gemaakt. Vaak is dit om beveiligingsredenen in uw productieapplicatie. Overweeg deze vereiste voor uw testbuild te verwijderen om volledige functionaliteit in het axe DevTools Mobile Dashboard mogelijk te maken.

• Android - FLAG_SECURE

Sommige Android-scannamen die standaard aan de schermtitel zijn gekoppeld, zullen verschijnen als de volledige klasnaam 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 vanaf het dashboard of frameworks. (#1643)