axe DevTools Mobile 2 juli 2025 release-opmerkingen

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 de iOS Analyzer 1.4.7 voorkomt dat scans worden uitgevoerd, met de melding "Test Mislukt". Om scans op een fysiek apparaat uit te voeren, update naar het nieuwste iOS Analyzer-project.

Functionaliteit met testen van een applicatie op bundel-ID was kapot in versie 2.8.1, wat resulteerde in een fout met de titel "Geen doeltoepad voor applicatie gespecificeerd via testconfiguratie: ...". Update naar 2.8.2 of de nieuwste versie om de fout op te lossen. Update naar het nieuwste binnen het iOS Analyzer-project.

Scanning van sommige applicaties met deze versie van de analyzer en SDK zou resulteren in een fout "Kon AxeResult niet serialiseren". 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 onjuist gevonden associatedText-eigenschap (#1622)

Er is een probleem dat de iPhone 15 Pro simulator beïnvloedt, dat voorkomt dat de Ondersteunt dynamische typeregel wordt uitgevoerd. Als u bent ingeschreven voor de Ondersteunt dynamische typeregel, kunt u deze niet testen met een iPhone 15 Pro simulator. Er is een bug 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 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 van Apple te controleren zijn mogelijk onnauwkeurig wanneer een `accessibilityIdentifier` is ingesteld op de afbeelding. Vanwege dit onverwachte gedrag zullen resultaten voor ImageView Name-problemen in UIKit-apps rapporteren als review nodig. Er is een bugrapport ingediend bij Apple. (#1633)

We werken actief aan oplossingen voor de volgende valse positieven en zullen deze lijst bijwerken zodra er oplossingen zijn uitgebracht.

In Scroll View
Kan problemen melden voor tekst binnen elementen die zich als banners gedragen. 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 focusbaar is door VoiceOver, en het heeft focusbare besturingselementen binnenin genesteld, kan ActiveControlName een vals positief rapporteren op de UIImageView. Het verwijderen van de `accessibilityIdentifier` lost het probleem op. Er is een bug ingediend bij Apple. (#1633)

Label In Name and Label At Front
Deze twee regels zoeken naar het zichtbare label van een besturingselement tussen nabijgelegen elementen om de status van de regel te bepalen. In sommige weergavehiërarchieën kan de onjuiste nabijgelegen 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 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 wordt uitgevoerd op deze weergave.

Apps geschreven met 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-applicatie 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 het niet officieel wordt ondersteund.

U kunt resultaten zien voor weergaven die verborgen zijn achter andere weergaven op het scherm. Deze verborgen weergaven zijn niet toegankelijk 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 te worden opgelost 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 zou automatisch moeten worden geïmporteerd bij het refereren aan axe DevTools Mobile in uw geautomatiseerde Espresso- of UIAutomator-tests. In sommige gevallen echter gebeurt de automatische import 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 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:

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

De Touch Target Spacing-regel draait momenteel niet op slidercomponenten die zijn geschreven in Jetpack Compose. Er kan op dit moment geen actie worden ondernomen. Een oplossing komt echter binnenkort!

Op Android API 30 heeft een van de locaties waar we proberen resultaten lokaal op te slaan een toestemmingfout. Het resultaat wordt desondanks als een JSON-bestand opgeslagen. 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
//    }
}

In sommige hybride en cross-platform apps kunnen we onverwachte resultaten terugkrijgen wanneer items in een scrollview gedeeltelijk van het scherm zijn. Om een element te testen op toegankelijkheid, zorg ervoor dat het volledig op het scherm staat 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, zorg ervoor dat deze instelling niet is ingeschakeld. Als je ervoor hebt gekozen om deze functie te gebruiken vanwege de beveiligingsverbeteringen, raden we aan om deze uit te laten voor interne testversies waarin je veilig testgegevens kunt gebruiken en beveiligingsproblemen zo 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 aanroepen naar de methode bij setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de getroffen activiteitvensters.

Om de volledige functionaliteit van axe DevTools voor mobiel te ontgrendelen, zorg ervoor dat screenshots zijn ingeschakeld. We raden aan screenshots in te schakelen op een debug- of testversie van je app die gebruikmaakt van testgegevens om beveiligingsproblemen te voorkomen. Bekijk onze gids voor het inschakelen van screenshots in Android-apps.

Als je je build minimaliseert, krijg je een crash met een foutlogboek waarin wordt gemeld dat een adapter niet kan worden gevonden wanneer je probeert in te loggen bij de axe DevTools-bibliotheek. Schakel minimalisatie uit voor je debug-builds waarin axe DevTools is 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 alstublieft de lay-out-agnostische API's om updates te blijven ontvangen. Als je de Compose-API's blijft gebruiken en een fout tegenkomt in de trant van `Er werd precies '1' knooppunt verwacht maar er zijn '2' knooppunten gevonden die voldoen aan: (isRoot)` of `Geen View geïnitialiseerd, heb je AxeDevToolsCompose.setComposeTestRule() genoemd?`, raadpleeg dan de Compose setTestTag API.

Als je dit bericht tegenkomt, kunnen sommige regelresultaten mogelijk niet naar verwachting terugkeren wanneer die regel gebruikmaakt van kunstmatige intelligentie. Betrokken regels zijn onder andere Kleurcontrast, Focusbare Tekst en Genestelde Elementnaam. (#841)

Door beperkingen van de MAUI-apparchitectuur in het Android-ecosysteem, zal de Bewerken tekstnaamregel als Beoordeling vereist worden weergegeven in het dashboard wanneer een mislukking wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig in dit geval handmatig het juiste gedrag.

Wanneer je aangepaste dialogen of modals implementeert die de native bedieningselementen niet uitbreiden, kun je resultaten krijgen voor weergaven achter de modal. In dit geval raden we aan onze tool niet tegen deze aangepaste modals of dialogen te laten lopen, maar ze in plaats daarvan handmatig te controleren om ervoor te zorgen dat ze naar wens functioneren met ondersteunende technologie.

Als de screenshot ontbreekt op de details-pagina van de scan, kan je app screenshots verhinderen. Dit gebeurt vaak om beveiligingsredenen in je productie-applicatie. Overweeg om deze vereiste te verwijderen voor je test-build zodat de volledige functionaliteit in het axe DevTools Mobile Dashboard beschikbaar is.

• Android - FLAG_SECURE

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