Axe DevTools Mobile release-opmerkingen 4 februari 2026

Bij het uitvoeren van toegankelijkheidscontroles op kleinere schermformaten of met kleinere lettergroottes, kan de Kleurcontrastregel valse positieven rapporteren voor gradientachtergronden. In dergelijke gevallen kan het niet de voorgrondkleur bepalen en vergelijkt in plaats daarvan achtergronden met elkaar, wat resulteert in een fout.

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

Apple's toegankelijkheids-API's kunnen ten onrechte webinhoud binnen WKWebView rapporteren als „isVisible“, zelfs wanneer de webweergave bedekt is 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 en waarneembaar is voor de gebruiker.

iOS 26 bevat een toegankelijkheidsprobleem waarbij standaardstapperknoppen niet "gedimd" aankondigen via Assistentietechnologie om aan te geven dat ze niet ingeschakeld zijn. Hierdoor beschouwen de iOS-regels deze knoppen ook als ingeschakeld, zelfs als dat niet zo is. Er is een bugrapport ingediend bij Apple, maar totdat dit is opgelost, kunnen de volgende regels resultaten rapporteren op uitgeschakelde stapperknoppen: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze bug oplost, zal de oplossing zijn om [de regels te negeren](ios-ignore-rule). De standaardstapperknoppen hebben de identificaties „Decrement“ en „Increment“, en kunnen indien nodig worden genegeerd op 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 associatedText-eigenschap (#1622)

Er is een probleem met de iPhone 15 Pro-simulator dat voorkomt dat de Ondersteunt Dynamic Type-regel wordt uitgevoerd. Als u bent ingeschreven voor de Ondersteunt 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 teruggegeven in de toegankelijkheidsboom. Er is een bugrapport ingediend bij Apple. (#1110)

In UIKit-apps is een afbeelding zonder een accessibilityLabel standaard niet focusbaar met assistentietechnologie.
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-Naamproblemen in UIKit-apps worden gerapporteerd als „Beoordeling nodig“. Er is een bugrapport ingediend bij Apple. (#1633)

We werken actief aan oplossingen voor de volgende valse positieven en zullen deze lijst bijwerken zodra oplossingen beschikbaar zijn.

In Scroll View
Kan problemen rapporteren voor tekst binnen bannerelementen. Om deze elementen beschikbaar te maken voor degenen die grotere tekst nodig hebben, gebruikt u 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 controles die erin genest zijn, kan ActiveControlName een valse positieve melding geven 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 een zichtbare label van een controle onder nabije elementen om te helpen bij het bepalen van de regelstatus. In sommige weergavehiërarchieën kan de verkeerde nabije tekst worden gedetecteerd, waardoor deze regels falen. (#1622)

In sommige gevallen is assistentietechnologie afhankelijk van AccessibilityEvent omschrijvingen van het Android-systeem om informatie aan de gebruiker aan te kondigen wanneer er geen andere aankondiging beschikbaar is. Aangezien AccessibilityEvents are triggered by user actions, we are unable to access the correct description if this information is not provided.

Om dit probleem te vermijden, moet ervoor worden gezorgd dat alle relevante weergaven als belangrijk voor toegankelijkheid worden gemarkeerd. Dit maakt het mogelijk voor Talkback om de informatie uit de weergave te halen, die ons hulpmiddel dan 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 waarin de tekst in een weergave dezelfde kleur heeft als de achtergrond, kan ons Machine Learning-algoritme niet detecteren of er tekst aanwezig is, waardoor de kleurcontrastregel niet wordt uitgevoerd op deze weergave.

Apps geschreven met XML die de hinttekstfunctie gebruiken, 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. 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 belangrijk is dat de app toegankelijk is op eerdere versies van Android, kunt u overwegen het gebruik van de hintText functie te vermijden, omdat 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 assistentietechnologie, 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 de nauwkeurigheid van resultaten te waarborgen. 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:

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

De regel voor aanraakdoelafstand wordt momenteel niet toegepast op slidercomponenten die met Jetpack Compose zijn geschreven. Momenteel kan er geen actie worden ondernomen. Echter, er komt binnenkort een oplossing!

Op Android API 30, treedt er een vergunningfout op bij een van de locaties waar we proberen resultaten lokaal op te slaan. Ondanks deze fout wordt het resultaat nog steeds als JSON-bestand opgeslagen. De fout kan worden onderdrukt 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
// }
}

Let op dat deze code alleen voor API 30 moet worden uitgeschakeld, omdat het anders problemen kan veroorzaken bij het lokaal opslaan voor andere API-niveaus.

In sommige hybride en cross-platform apps kunnen we onverwachte resultaten teruggeven als items in een scrollweergave gedeeltelijk buiten het scherm liggen. 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) werd de mogelijkheid geïntroduceerd om niet-systeem-overlay's te verbergen. Om de axe Analyzer-app te gebruiken, zorg ervoor dat deze instelling niet is ingeschakeld. Als u ervoor heeft gekozen om deze functie te gebruiken vanwege de beveiligingsverbeteringen, raden we aan deze uit te laten voor interne testversies waar u veilig testgegevens kunt gebruiken en zodoende beveiligingsproblemen kunt vermijden. 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 oproepen naar de methode setHideOverlayWindows(true) bij setHideOverlayWindows(false) op de getroffen activiteitsvensters.

Om de volledige functionaliteit van axe DevTools voor mobiel 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 gesimuleerde 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 foutlogboek waarin staat dat een adapter niet gevonden kon worden bij het inloggen op de axe DevTools-bibliotheek. Schakel 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 fout vergelijkbaar met:
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 agnostische API's om updates te blijven ontvangen. Als u de Compose-API's blijft gebruiken en een fout tegenkomt in de trant van `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 mogelijk niet zoals verwacht terugkeren wanneer die regel gebruikmaakt van kunstmatige intelligentie. Aangetaste regels zijn onder meer Kleurcontrast, Focusbare tekst en Genestelde elementnaam. (#841)

Vanwege beperkingen van de MAUI-app architectuur rendering in het Android-ecosysteem, zal de Edit Text Naamregel als Moet Worden Beoordeeld worden weergegeven in het dashboard wanneer 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 geen gebruik maken van de native controls, kunt u resultaten krijgen voor weergaven achter de modal. In dit geval raden we aan ons hulpmiddel niet te gebruiken tegen deze aangepaste modalen of dialogen, maar ze in plaats daarvan handmatig te controleren om ervoor te zorgen dat ze met ondersteunende technologie naar wens functioneren.

Als de schermafbeelding ontbreekt op de pagina met scanresultaten, kan uw app voorkomen dat er screenshots worden gemaakt. Dit is vaak om veiligheidsredenen in uw productieapplicatie. Overweeg om deze eis voor uw testbuild te verwijderen om volledige functionaliteit in het axe DevTools Mobile Dashboard te realiseren.

• Android - FLAG_SECURE

Sommige Android-scan-namen die standaard de schermtitel zijn, 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 tijdelijke oplossing kunt u de scan-naam instellen vanuit het dashboard of frameworks. (#1643)