Axe DevTools Mobile April 8, 2026 Release-opmerkingen

Wanneer toegankelijkheidscontroles worden uitgevoerd op kleinere schermformaten of met kleinere lettergroottes, kan de regel Kleurcontrast valse positieven rapporteren voor gradiëntachtergronden. In dergelijke gevallen kan het de voorgrondkleur niet bepalen en in plaats daarvan achtergrondkleuren met elkaar vergelijken, wat resulteert in een mislukking.

Om dit probleem te omzeilen, probeer 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 wordt bedekt door native overlays (zoals modale weergaven, waarschuwingen of andere native UI-elementen). Dit komt doordat 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 standaardstappentellers niet "gedimd" worden aangekondigd door Assistive Technology om aan te geven dat ze niet ingeschakeld zijn. Hierdoor worden deze knoppen ook door de iOS-regels als ingeschakeld beschouwd, ook al zijn ze dat niet. Er is een bugrapport ingediend bij Apple, maar totdat dit is opgelost, kunnen de volgende regels resultaten rapporteren op uitgeschakelde stappentellers: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze bug verhelpt, is de oplossing om [de regels te negeren](ios-ignore-rule). De standaard bedieningsknoppen hebben de identificatoren „Decrement“ en „Increment“ en kunnen indien nodig op identificator 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 als gevolg van een onjuiste gevonden associatedText-eigenschap (#1622)

Er is een probleem dat de iPhone 15 Pro-simulator beïnvloedt en voorkomt dat de regel voor dynamisch typen wordt uitgevoerd. Als u bent ingeschreven voor de regel voor dynamisch typen, kunt u deze niet testen met een iPhone 15 Pro-simulator. Er is een bug gemeld bij Apple.

Tijdens het bekijken van een verbetering voor onze regels ontdekten we dat in XCTest, geneste controles niet worden weergegeven in de toegankelijkheidsstructuur. Er is een bug gemeld bij Apple. (#1110)

In UIKit-apps is een afbeelding zonder een `accessibilityLabel` niet standaard focusbaar met assistieve technologie.
De eigenschappen die we gebruiken om focusbaarheid van Apple te controleren, kunnen onnauwkeurig zijn wanneer een `accessibilityIdentifier` op de afbeelding is ingesteld. Vanwege dit onverwachte gedrag worden resultaten voor ImageView Naamproblemen in UIKit-apps gerapporteerd als 'Beoordeling vereist'. Er is een bugrapport ingediend bij Apple. (#1633)

We werken actief aan oplossingen voor de volgende valse positieven en zullen deze lijst bijwerken wanneer problemen opgelost zijn.

In Scroll View
Tekst binnen banner-achtige elementen kan worden gemarkeerd met een 'Beoordeling vereist'-bericht. 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 met VoiceOver, en het heeft focusbare controles erin genest, dan kan ActiveControlName een vals positief rapporteren 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 een zichtbaar label van een controle tussen nabijgelegen elementen om de regelstatus te bepalen. In sommige weergavehiërarchieën kan de verkeerde nabijgelegen tekst worden gedetecteerd, waardoor deze regels falen. (#1622)

In sommige gevallen vertrouwen assistieve technologieën op AccessibilityEvent beschrijvingen van het Android-systeem om informatie aan de gebruiker aan te kondigen 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 vermijden, zorgt u ervoor dat alle relevante weergaven als belangrijk worden gemarkeerd voor toegankelijkheid. Dit stelt Talkback in staat om de informatie van de weergave te benaderen, die onze tool vervolgens kan detecteren.

Onze kleurcontrastregel is afhankelijk van machinaal leren 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 machinaal leren-algoritme niet in staat om te detecteren of er tekst aanwezig is, waardoor de kleurcontrastregel niet op deze weergave wordt uitgevoerd.

Apps geschreven in 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 wijst de hinttekst toe 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 uit te voeren op nieuwere versies van Android. Als het belangrijk is dat de app toegankelijk is op eerdere Android-versies, overweeg dan 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 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 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 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. Voeg in het build.gradle bestand van uw applicatie het volgende toe onder dependencies:

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

De regel voor aanraakdoelafstand wordt momenteel niet uitgevoerd op schuifcomponenten 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 probleem met permissies. Het resultaat wordt nog steeds opgeslagen als een JSON-bestand ondanks dat deze fout wordt weergegeven. De fout kan onderdrukt worden 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 retourneren wanneer items in een scrollweergave gedeeltelijk buiten beeld zijn. Om een element te testen op toegankelijkheid, zorgt u ervoor dat het volledig in beeld is voordat u de scan uitvoert.

Met API 31 (Android 12) is de mogelijkheid geïntroduceerd om niet-systeemoverlays te verbergen. Om van de axe Analyzer-app gebruik te kunnen maken, zorgt u ervoor dat deze instelling niet is ingeschakeld. Als u ervoor heeft gekozen om deze functie te gebruiken vanwege zijn beveiligingsverbeteringen, raden we aan om deze uit te laten voor interne testversies waar u veilig testgegevens kunt gebruiken en op die manier beveiligingsproblemen kunt uitsluiten. Note: this setting does not affect Google's accessibility scanner app as it's considered a system overlay.

Om de app axe Accessibility Analyzer te gebruiken, werk alle oproepen naar de methode bij setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de getroffen activiteitvensters.

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

Als je je build minimaliseert, zie je een crash met een foutlog dat meldt dat een adapter niet gevonden kan worden bij het proberen in te loggen op de axe DevTools-bibliotheek. Schakel minimaliseren uit voor je 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-onafhankelijke API's om updates te blijven ontvangen. Als je de Compose API's blijft gebruiken en een fout tegenkomt als ‘Precies '1' node verwacht, maar '2' nodes gevonden die voldoen aan: (isRoot)’ of ‘Geen View geïnitialiseerd, heb je AxeDevToolsCompose.setComposeTestRule() aangeroepen?’, raadpleeg dan Compose setTestTag API.

Vanwege beperkingen van de MAUI app-architectuur in het Android-ecosysteem, wordt de regel Edit Text Name weergegeven als 'Moet Beoordeeld Worden' in het dashboard wanneer een fout wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig in dit geval handmatig het correcte gedrag.

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

Als de schermafbeelding ontbreekt op de scangedetailspagina, kan het zijn dat je app het maken van schermafbeeldingen verhindert. Vaak is dit om veiligheidsredenen in je productieapplicatie. Overweeg om deze eis te verwijderen voor je testbuild om volledige functionaliteit in het axe DevTools Mobile Dashboard mogelijk te maken.

• Android - FLAG_SECURE

Sommige Android-scan namen die standaard de schermtitel krijgen, worden weergegeven als de volledige class-naam inclusief het bundle-ID. In een toekomstige release zal dit worden opgelost zodat de schermtitel in een leesbaardere naam wordt opgemaakt. Als tijdelijke oplossing kun je de scan naam instellen vanuit het dashboard of frameworks. (#1643)