axe DevTools Mobile Release-opmerkingen van 24 september 2025

iOS 26 bevat een toegankelijkheidsbug waarbij standaard stepper-knoppen niet als "gedimd" worden aangegeven door ondersteunende technologieën om te laten zien dat ze niet zijn ingeschakeld. Hierdoor zien de iOS-regels deze knoppen ook als ingeschakeld, zelfs als dit niet het geval is. 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 identificaties "Decrement" en "Increment" en kunnen indien nodig op 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.

Een configuratie-instelling in iOS Analyzer 1.4.7 voorkomt dat scans worden uitgevoerd, wat resulteert in het bericht "Test mislukt". Om scans op een fysiek apparaat uit te voeren, update naar het nieuwste iOS Analyzer-project.

Functionaliteit met het testen van een applicatie via bundle-identificatie was gebroken in versie 2.8.1, wat resulteerde in een fout getiteld "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 applicaties met deze versie van de analyzer en SDK resulteerde 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 valse positieven rapporteren met LabelInName en LabelAtFront vanwege een onjuiste associatedText-eigenschap die wordt gevonden (#1622)

Er is een probleem met de iPhone 15 Pro-simulator waardoor de Supports Dynamic Type-regel niet wordt uitgevoerd. Als u aangemeld bent voor de Supports Dynamic Type-regel, kunt u deze niet testen met behulp van 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 besturingselementen niet worden weergegeven in de toegankelijkheidsboom. Er is een bugrapport ingediend bij Apple. (#1110)

In UIKit-apps is een afbeelding zonder een accessibilityLabel niet standaard focusbaar met ondersteunende technologieën.
De eigenschappen die we gebruiken om de focusbaarheid vanaf Apple te controleren, kunnen onnauwkeurig zijn wanneer een accessibilityIdentifier op de afbeelding is ingesteld. Vanwege dit onverwachte gedrag zullen resultaten voor ImageView Name-problemen in UIKit-apps worden gerapporteerd als Evaluatie Nodig. Er is een bugrapport ingediend bij Apple. (#1633)

We zijn actief bezig met het oplossen van de volgende false positives en zullen deze lijst bijwerken zodra oplossingen zijn uitgebracht.

In Scroll View
Kan problemen melden voor tekst binnen elementen die zich als een banner gedragen. Om deze elementen beschikbaar te maken voor mensen 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 door VoiceOver kan worden gefocust, en het bevat focusbare besturingselementen binnenin, 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 besturingselement tussen naburige elementen om de status van de regel te bepalen. In sommige weergave-hiërarchieën kan de onjuiste naburige tekst worden gedetecteerd, waardoor deze regels kunnen 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 in een weergave dezelfde kleur heeft als de achtergrond, kan ons Machine Learning-algoritme niet detecteren of er tekst aanwezig is, zodat de Kleurcontrastregel niet op deze weergave wordt toegepast.

Apps geschreven met XML die gebruik maken van de hinttekstfunctie kunnen false positives zien met de EditTextName regel. Hinttekst werd pas geïntroduceerd met Android 8 (SDK 26). Door dit element in uw XML-app te gebruiken, wordt de hinttekst toegewezen aan de waarde van het tekstinvoerveld. Meer recente versies van Android zijn beter toegerust om deze ervaring toegankelijk te maken.

Om dit probleem te verhelpen, 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 Android-versies, kunt u overwegen om 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 ondersteunende technologieën, 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 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. In het build.gradle bestand van uw applicatie, voeg het volgende toe onder dependencies:

De Aanrakingsdoelafstandregel werkt momenteel niet op schuifregelaars 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 als een JSON-bestand opgeslagen, ondanks dat deze fout wordt weergegeven. De fout kan worden onderdrukt door de code in het volgende blok commentaar te geven:
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 becommentarieerd, omdat het problemen zal veroorzaken bij het lokaal opslaan voor andere API-niveaus.

In sommige hybride en cross-platform apps kunnen we onverwachte resultaten retourneren wanneer items in een scrollweergave gedeeltelijk van het scherm af zijn. 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 kunnen gebruiken, zorg ervoor dat deze instelling niet is ingeschakeld. Als je ervoor hebt gekozen om deze functie te gebruiken vanwege de beveiligingsverbeteringen, raden we aan deze voor interne testbuilds uit te laten waar je 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 de axe Accessibility Analyzer-app te gebruiken, werk alle oproepen naar de methode bij setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de getroffen activiteitsvensters.

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

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

Een build met r8 ingeschakeld kan proberen de axeDevTools-bibliotheek te minimaliseren resulterend 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, 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 alstublieft de lay-out 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 je dit bericht ziet, kunnen sommige regels niet het verwachte resultaat opleveren wanneer die regel gebruikmaakt van kunstmatige intelligentie. Betreffende regels zijn onder andere Kleurcontrastratio, Focusbare Tekst en Geneste Elementnaam. (#841)

Vanwege beperkingen van de MAUI app-architectuur in het Android-ecosysteem, zal de regel voor Bewerken Tekstnaam als 'Nodigt uit tot beoordeling' in het dashboard worden weergegeven wanneer een fout wordt vermoed voor SDK versie 5.5.0 en hoger. Bevestig in dit geval het juiste gedrag handmatig.

Wanneer je aangepaste dialogen of modals implementeert die geen gebruikmaken van de native controls, kun je resultaten krijgen voor weergaven achter de modal. In dit geval raden we aan om onze tool niet tegen deze aangepaste modals of dialogen te gebruiken, maar in plaats daarvan handmatig te controleren of ze naar wens functioneren met hulpmiddelen.

Als de screenshot ontbreekt op de scangedetailleerde pagina, kan het zijn dat je app voorkomt dat er screenshots worden gemaakt. Vaak is dit om veiligheidsredenen in je productieapplicatie. Overweeg om deze eis voor je testbuild te verwijderen om volledige functionaliteit in de axe DevTools Mobile Dashboard mogelijk te maken.

• Android - FLAG_SECURE

Sommige Android-scan namen die standaard op de schermtitel zijn ingesteld, zullen verschijnen als de volledige class-naam inclusief de bundle identifier. In een toekomstige release zal dit worden opgelost zodat de schermtitel wordt omgezet naar een leesbaardere naam. Als tijdelijke oplossing kun je de scan naam instellen vanuit het dashboard of frameworks. (#1643)