Axe DevTools Mobile Release-opmerkingen van 19 december 2025

Bij het uitvoeren van toegankelijkheidscontroles op kleinere schermformaten of met kleinere lettergroottes, kan de kleurcontrastregel valse positieven melden voor gradiëntachtergronden. In dergelijke gevallen kan het onvermogen hebben om de voorgrondkleur te 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. U kunt er ook voor kiezen om de regel in uw tests te negeren en het kleurcontrast handmatig te controleren voor deze weergaven.

Apple's toegankelijkheids-API's kunnen webinhoud in WKWebView onjuist rapporteren als „isVisible“, zelfs wanneer de webview is bedekt met 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 onbedekt en waarneembaar is voor de gebruiker.

iOS 26 bevat een toegankelijkheidsfout waarbij standaard stapperknoppen niet als „gedimd“ worden aangekondigd door ondersteunende technologie 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 uitgeschakelde stapperknoppen: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze fout herstelt, kunt u [de regels negeren](ios-ignore-rule). De standaard stapperknoppen hebben de aanduidingen „Decrement“ en „Increment“, en kunnen indien nodig worden genegeerd op basis van aanduiding.

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

Er is een probleem dat de iPhone 15 Pro-simulator beïnvloedt waardoor de Ondersteunt Dynamisch Type-regel niet kan worden uitgevoerd. Als u bent aangemeld voor de Ondersteunt Dynamisch Type-regel, kunt u deze niet testen met een iPhone 15 Pro-simulator. Er is een bug ingediend bij Apple.

Bij het onderzoeken van een verbetering voor onze regels, ontdekten we dat in XCTest, geneste controles niet worden weergegeven in de toegankelijkheidsboom. 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 focusbaarheid te controleren van Apple kunnen onnauwkeurig zijn wanneer een accessibilityIdentifier is ingesteld op de afbeelding. Vanwege dit onverwachte gedrag zullen resultaten voor ImageView Name-problemen in UIKit-apps worden gerapporteerd als Nader Onderzoek Nodig. Er is een bugrapport ingediend bij Apple. (#1633)

We werken actief aan oplossingen voor de volgende vals positieven en zullen deze lijst bijwerken zodra oplossingen worden vrijgegeven.

In Scroll View
Kan problemen rapporteren voor tekst binnen banner-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 in focus komt bij VoiceOver, en het bevat focusbare bedieningselementen, kan ActiveControlName een vals positief resultaat 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 tussen naburige elementen om de regelstatus te bepalen. In sommige weergavehiërarchieën kan de verkeerde naburige tekst worden gedetecteerd, waardoor deze regels 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, waardoor de Kleurcontrastregel niet op deze weergave wordt toegepast.

Apps geschreven met XML die gebruikmaken van de hintteksteigenschap 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. Recentere 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 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 toch 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 hoeven niet opgelost te worden om toegankelijkheid te garanderen.

ML Kit tekstherkenning is vereist in veel van de axe DevTools Mobile-regels om nauwkeurigheid van de resultaten te waarborgen. De ML Kit-bibliotheek moet automatisch worden geïmporteerd bij het refereren 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 te overwinnen, moet u de ML Kit-bibliotheek handmatig in uw project importeren. In uw applicatie build.gradle bestand, en voeg het volgende toe onder dependencies:

De Touch Target Afstandsregel wordt momenteel niet uitgevoerd op enig schuifcomponent dat in Jetpack Compose is geschreven. Op dit moment kan geen actie worden ondernomen. Er komt echter snel 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 schakelen:
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 moet worden uitgeschakeld voor API 30, omdat dit problemen veroorzaakt 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 deels buiten het scherm vallen. 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 niet is ingeschakeld. Als u ervoor gekozen hebt om deze functie te gebruiken vanwege de beveiligingsverbeteringen, raden we aan deze uit te laten voor interne testbuilds waar u veilig testgegevens kunt gebruiken en op die manier beveiligingsproblemen 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 eventuele aanroepen naar de methode setHideOverlayWindows(true) bij op de betreffende activiteitvensters. setHideOverlayWindows(false) op de getroffen activiteitvensters.

Om volledige functionaliteit van axe DevTools voor Mobiel 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 mock-gegevens gebruikt om beveiligingsproblemen te voorkomen. Bekijk onze handleiding voor het inschakelen van schermafbeeldingen in Android-apps.

Als u uw build minimaliseert, ziet u een crash met een foutlogboek waarin wordt gemeld dat een adapter niet kon worden gevonden bij het proberen in te loggen 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 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, 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 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 tegenkomt, kunnen sommige regelresultaten mogelijk niet overeenkomstig de verwachtingen terugkeren wanneer die regel kunstmatige intelligentie gebruikt. Beïnvloede regels omvatten Kleurencontrast, Focusbare tekst en Geneste elementnaam. (#841)

Vanwege beperkingen in de weergave van de MAUI-apparchitectuur in het Android-ecosysteem, zal de regel Bewerken Tekstnaam als Beoordeling Nodig worden weergegeven op het dashboard wanneer een fout wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig handmatig het correcte gedrag voor dit geval.

Wanneer je aangepaste dialogen of modalen implementeert die de native controles niet uitbreiden, kun je resultaten krijgen voor weergaven achter de modal. In dit geval raden we aan om onze tool niet te gebruiken voor deze aangepaste modalen of dialogen en ze in plaats daarvan handmatig te controleren om ervoor te zorgen dat ze naar wens werken met ondersteunende technologie.

Als de screenshot ontbreekt op de scan-details pagina, kan het zijn dat je app voorkomt dat er screenshots worden gemaakt. Vaak geldt dit om veiligheidsredenen in je productieapplicatie. Overweeg om deze vereiste voor je testbuild te verwijderen, zodat je de volledige functionaliteit in de axe DevTools Mobile Dashboard kunt toestaan.

• Android - FLAG_SECURE

Sommige Android-scan namen die standaard worden ingesteld op de schermtitel, zullen verschijnen als de volledige klassennaam inclusief de pakketidentificatie. In een toekomstige release zal dit worden opgelost zodat de schermtitel wordt opgemaakt in een meer leesbare naam. Als tijdelijke oplossing kun je de scan naam instellen via het dashboard of frameworks. (#1643)