Axe DevTools Mobile 18 mei 2026 Release Opmerkingen

Bij het uitvoeren van toegankelijkheidscontroles op kleinere schermformaten of met kleinere lettergroottes kan de Kleurcontrastregel valse positieven rapporteren voor gradiëntachtergronden. In dergelijke gevallen kan het systeem de voorgrondkleur niet bepalen en in plaats daarvan achtergrondkleuren onderling vergelijken, wat resulteert in een foutmelding.

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

Apple's toegankelijkheids-API's kunnen webcontent binnen WKWebView onjuist rapporteren als „isVisible“, zelfs wanneer de webview is bedekt door native overlays (zoals modale weergaven, meldingen of andere native UI-elementen). Dit gebeurt omdat het toegankelijkheidssysteem controleert of de WKWebView-container zelf zichtbaar is, in plaats van of de webcontent daadwerkelijk onbelemmerd en waarneembaar is voor de gebruiker.

iOS 26 bevat een toegankelijkheidsbug waarbij standaard stapknoppen niet "gedimd" aangeven door Hulpmiddelen voor Toegankelijkheid om aan te geven dat ze niet ingeschakeld zijn. 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 stapknoppen: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze bug oplost, is de oplossing om [de regels te negeren](ios-ignore-rule). De standaard stapknoppen hebben de identificators "Verlagen" en "Verhogen" en kunnen indien nodig genegeerd worden op identificator.

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 geassocieerdeText-eigenschap (#1622)

Er is een probleem met de iPhone 15 Pro-simulator waardoor de Ondersteunt Dynamische Type-regel niet kan worden uitgevoerd. Als u bent aangemeld voor de Ondersteunt Dynamische 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 besturingselementen niet worden geretourneerd in de toegankelijkheidsboom. Er is een bugrapport ingediend bij Apple. (#1110)

In UIKit-apps is een afbeelding zonder een `accessibilityLabel` niet standaard focusbaar met hulpmiddelen voor toegankelijkheid.
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 worden resultaten voor ImageView Name-kwesties in UIKit-apps gerapporteerd als Beoordeling Nodig. Er is een bugrapport ingediend bij Apple. (#1633)

We zijn actief bezig met oplossingen voor de volgende valse positieven en zullen deze lijst bijwerken zodra er oplossingen zijn vrijgegeven.

In Scroll View
Tekst binnen banner-gedragselementen kan worden gemarkeerd met een boodschap „Beoordeling Nodig". 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 door VoiceOver kan worden gefocust en het focusbare besturingselementen bevat die erin genest zijn, kan ActiveControlName een vals positief resultaat rapporteren 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 zichtbaar label van een besturingselement tussen nabijgelegen elementen om de regelstatus te bepalen. In sommige weergave-hiërarchieën kan de onjuiste nabijgelegen tekst worden gedetecteerd, waardoor deze regels falen. (#1622)

In sommige gevallen vertrouwen hulpmiddelen voor toegankelijkheid op AccessibilityEvent beschrijvingen 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 voorkomen, zorg ervoor dat alle relevante weergaven als belangrijk zijn gemarkeerd voor toegankelijkheid. Hierdoor kan Talkback toegang krijgen tot de informatie van de weergave, die onze tool vervolgens kan detecteren.

Onze kleurcontrastregel hangt af 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 die in een weergave is opgenomen dezelfde kleur heeft als de achtergrond, kan ons machine learning-algoritme niet detecteren of er tekst aanwezig is, en wordt de kleurcontrastregel niet uitgevoerd voor deze weergave.

Apps die met XML zijn geschreven en de hinttekstfunctie gebruiken, kunnen valse positieven tegenkomen bij de EditTextName regel. Hinttekst werd pas geïntroduceerd vanaf 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 op te lossen, 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 versies van Android, 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 meldt ze toch als problemen.

We werken aan een oplossing voor dit complexe probleem. Als TalkBack deze weergaven in de tussentijd 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 garanderen. De ML Kit-bibliotheek zou automatisch moeten worden geïmporteerd wanneer u verwijst 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 foutmelding in de logcat:

Axe DevTools Android: Error while running mlKit Text Detection: MlKitContext has not been initialized.

Om dit probleem te verhelpen, dient u de ML Kit-bibliotheek handmatig in uw project te importeren. In de build.gradle van uw applicatiebestand, voeg het volgende toe onder dependencies:

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

De aanraakdoelafstandregel wordt momenteel niet uitgevoerd op schuifcomponenten die zijn geschreven in Jetpack Compose. Er kan op dit moment geen actie worden ondernomen. Er komt echter snel een oplossing!

Op Android API 30 treedt er een permissiefout op bij een van de locaties waar we proberen resultaten lokaal op te slaan. Het resultaat wordt nog steeds als een JSON-bestand opgeslagen, 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 teruggeven wanneer items in een scrollweergave gedeeltelijk buiten beeld zijn. Om een element op toegankelijkheid te testen, moet u ervoor zorgen 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 de Axe Analyzer-app te gebruiken, moet u ervoor zorgen 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 gebruik kunt maken van testgegevens 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, update alle aanroepen naar de methode setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de getroffen activiteitvensters.

Om de volledige functionaliteit van Axe DevTools voor mobiel te ontgrendelen, moet u ervoor zorgen dat screenshots zijn ingeschakeld. We raden aan om screenshots in te schakelen op een debug- of testversie van uw app die gebruikmaakt van mock-gegevens om beveiligingsproblemen te vermijden. Bekijk onze gids voor het inschakelen van screenshots in Android-apps.

Als u uw build minimaliseert, ziet u een crash met een foutlogboek waarin staat dat er geen adapter kon worden gevonden bij het proberen in te loggen in de Axe DevTools-bibliotheek. Schakel minimalisatie uit voor uw debugs met Axe DevTools geïmplementeerd. (#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)
	

De Compose-API's zijn verouderd, gebruik alstublieft de layout-agnostische API's om updates te blijven ontvangen. Als u de Compose-API's blijft gebruiken en een fout tegenkomt zoals `Exact '1' node verwachtte maar '2' nodes gevonden die voldoen aan: (isRoot)` of `Geen weergave geïnitialiseerd, heeft u AxeDevToolsCompose.setComposeTestRule() aangeroepen?`, verwijzen we u naar de Compose setTestTag API.

Vanwege beperkingen van de MAUI-app-architectuur in het Android-ecosysteem, zal de Edit Text Name-regel als "Nader bekijken" worden weergegeven in het dashboard wanneer een fout wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig correct gedrag handmatig voor dit geval.

Wanneer u aangepaste dialogen of modals implementeert die niet de native besturingselementen uitbreiden, kunt u resultaten krijgen voor weergaven achter de modal. In dit geval raden we aan onze tool niet te gebruiken voor deze aangepaste modals of dialogen en in plaats daarvan handmatig te controleren of ze correct werken met ondersteunende technologie.

Als de screenshot ontbreekt op de scangedetailpagina, kan het zijn dat uw app het maken van screenshots verhindert. Dit is vaak om veiligheidsredenen in uw productieapplicatie. Overweeg deze vereiste te verwijderen voor uw testbuild om de volledige functionaliteit in het Axe DevTools Mobile Dashboard mogelijk te maken.

• Android - FLAG_SECURE

Sommige Android-scan namen die standaard worden ingesteld op de schermtitel, zullen verschijnen als de volledige klassennaam inclusief de bundelidentifier. In een toekomstige release zal dit worden opgelost zodat de schermtitel wordt omgezet in een beter leesbare naam. Als tijdelijke oplossing kunt u de scannaam instellen vanaf het dashboard of frameworks. (#1643)