Bekende Problemen

Bij het uitvoeren van toegankelijkheidscontroles op kleinere schermformaten of met kleinere letterformaten kan de Kleurcontrastregel false positives rapporteren voor verloopachtergronden. 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. Of u kunt ervoor kiezen de regel in uw tests te negeren en de Kleurcontrastregel handmatig te controleren voor deze weergaven.

De toegankelijkheids-API's van Apple kunnen webinhoud binnen WKWebView ten onrechte rapporteren als „isVisible“, zelfs wanneer de webweergave bedekt wordt door native overlays (zoals modale weergaven, 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 toegankelijkheidsbug waarbij standaard stepperknoppen niet „gedimd“ aankondigen via ondersteunende technologieën om aan te geven dat ze niet ingeschakeld zijn. Daardoor 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 gedeactiveerde stepperknoppen: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze bug oplost, is de oplossing om [de regels te negeren](ios-ignore-rule). De standaard stepperknoppen hebben de identificatie „Decrement“ en „Increment“ en kunnen indien nodig op basis van 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.

Sommige schermen kunnen false positives rapporteren met LabelInName en LabelAtFront vanwege een onjuiste gevonden associatedText-eigenschap (#1622)

Er is een probleem dat de iPhone 15 Pro-simulator beïnvloedt, waardoor de Ondersteunt Dynamic Type-regel niet kan draaien. Als u bent ingeschreven voor de Ondersteunt Dynamic Type-regel, kunt u deze niet testen met behulp van een iPhone 15 Pro-simulator. Er is een bugrapport ingediend bij Apple.

Bij het verbeteren van onze regels hebben we ontdekt 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` standaard niet focuseerbaar met ondersteunende technologie.
De eigenschappen die we gebruiken om focusability te controleren vanaf Apple kunnen onjuist zijn wanneer een `accessibilityIdentifier` is ingesteld op de afbeelding. Vanwege dit onverwachte gedrag rapporteren resultaten voor ImageView Name-problemen in UIKit-apps als Moet Beoordeeld Worden. Er is een bugrapport ingediend bij Apple. (#1633)

We werken actief aan oplossingen voor de volgende false positives en zullen deze lijst bijwerken zodra oplossingen zijn uitgebracht.

In Scroll View
Tekst binnen banner-gedragende elementen kan worden gemarkeerd met een „Moet Beoordeeld Worden“-bericht. 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 focuseerbaar is door VoiceOver, en er zich focuseerbare besturingselementen binnen bevinden, kan ActiveControlName een false positive 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 status van de regel te helpen bepalen. In sommige weergavehiërarchieën kan de onjuiste nabijgelegen tekst worden gedetecteerd, waardoor deze regels falen. (#1622)

In sommige gevallen vertrouwt assistieve technologie 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, zorg ervoor dat alle relevante weergaven als belangrijk voor toegankelijkheid worden gemarkeerd. Dit stelt Talkback in staat om de informatie uit de weergave te halen, die onze tool vervolgens 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 op deze weergave wordt uitgevoerd.

Apps geschreven met XML die gebruikmaken van de hinttekstfunctie kunnen false positives zien met de EditTextName regel. Hinttekst werd pas geïntroduceerd vanaf 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 op nieuwere versies van Android uit te voeren. Als het belangrijk is dat de app toegankelijk is op eerdere Android-versies, kunt u overwegen het gebruik van de hintText functionaliteit, 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 hulpmiddelen, 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 hoeven niet te worden opgelost om toegankelijkheid te garanderen.

ML Kit tekstherkenning 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 axe DevTools Mobile gebruikt in uw geautomatiseerde Espresso- of UIAutomator-tests. In sommige gevallen gebeurt die automatische import echter niet 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. In het build.gradle -bestand van uw applicatie voegt u het volgende toe onder dependencies:

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

De Aanraakdoelafstand-regel wordt momenteel niet toegepast op sliders 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 is er een toestemmingsfout op een van de locaties waar we proberen resultaten lokaal op te slaan. 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 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, zorg ervoor dat het volledig in beeld is voordat u de scan uitvoert.

Ingevoerd met API 31 (Android 12) is de mogelijkheid 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 deze functie te gebruiken vanwege de beveiligingsverbeteringen, raden we aan deze uit te schakelen voor interne testversies 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, moet u alle aanroepen naar de methode setHideOverlayWindows(true) wijzigen in setHideOverlayWindows(false) op de getroffen activiteitsvensters.

Om de volledige functionaliteit van axe DevTools voor Mobile te ontgrendelen, zorgt u ervoor dat schermafbeeldingen zijn ingeschakeld. We raden aan schermafbeeldingen in te schakelen op een debug- of testversie van uw app die gebruik maakt van mock data om beveiligingsproblemen te vermijden. Bekijk onze handleiding voor schermafbeeldingen inschakelen in Android-apps.

Als u uw build minimaliseert, zult u een crash zien met een foutlog dat meldt dat een adapter niet kon worden gevonden wanneer u probeert in te loggen op de axe DevTools bibliotheek. Schakel minify uit voor uw debug-builds met axe DevTools geïmplementeerd. (#729)

Een build met r8 ingeschakeld kan proberen de axeDevTools bibliotheek te minimaliseren, wat resulteert 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)
	

De Compose API's zijn verouderd, gebruik de layout-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.

Vanwege beperkingen in de MAUI-apparchitectuur in het Android-ecosysteem, zal de Edit Text Naam-regel als 'Moet worden beoordeeld' weergegeven 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 u aangepaste dialogen of modals implementeert die niet de native controles uitbreiden, kunt u 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 en in plaats daarvan ze handmatig te controleren om ervoor te zorgen dat ze zich gedragen zoals gewenst met hulpmiddelen.

Als de schermafbeelding ontbreekt op de scantdetailspagina, kan het zijn dat uw app voorkomt dat schermafbeeldingen worden gemaakt. Vaak is dit om veiligheidsredenen in uw productieapplicatie. Overweeg om deze vereiste voor uw testbuild te verwijderen om volledige functionaliteit in het axe DevTools Mobile Dashboard mogelijk te maken.

• Android - FLAG_SECURE

Sommige Android-scan namen die standaard overeenkomen met de schermtitel, zullen verschijnen als de volledige klassennaam inclusief de bundel-identificator. In een toekomstige release zal dit worden opgelost, zodat de schermtitel wordt opgemaakt in een beter leesbare naam. Als tijdelijke oplossing kunt u de naam van de scan instellen vanuit het dashboard of frameworks. (#1643)