axe DevTools Mobile release-opmerkingen 16 juli 2025

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, waardoor het bericht „Test mislukt“ wordt geretourneerd. Om scans op een fysiek apparaat uit te voeren, update naar het nieuwste iOS Analyzer-project.

Functionaliteit bij het testen van een applicatie via bundle-ID was defect in versie 2.8.1, wat resulteerde in een foutbericht met de titel „Geen doeltoepassingspad opgegeven via testconfiguratie: ...“. Update naar 2.8.2 of de nieuwste versie om de fout op te lossen. Update binnen het iOS Analyzer-project naar de nieuwste versie.

Het scannen van sommige toepassingen 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 met de iPhone 15 Pro-simulator dat voorkomt dat de Supports Dynamic Type-regel wordt uitgevoerd. Als u bent ingeschreven voor de Supports Dynamic Type-regel, 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 controles niet worden geretourneerd in de toegankelijkheidsboom. Er is een bug ingediend bij Apple. (#1110)

In UIKit-apps is een afbeelding zonder `accessibilityLabel` standaard niet focusbaar met ondersteunende technologie.
De eigenschappen die we gebruiken om focusbaarheid van Apple te controleren, kunnen onnauwkeurig zijn wanneer er een `accessibilityIdentifier` op de afbeelding is ingesteld. Vanwege dit onverwachte gedrag worden resultaten voor ImageView Name-problemen in UIKit-apps gerapporteerd als Behoeft Beoordeling. 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 worden vrijgegeven.

In Scroll View
Kan problemen melden voor tekst binnen elementen die zich als banier gedragen. Om deze elementen beschikbaar te maken voor degenen die grotere tekst vereisen, gebruik 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 er zijn focusbare bedieningselementen erin genesteld, kan ActiveControlName mogelijk een foutmelding geven over 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 een zichtbaar label van een bedieningselement tussen nabije elementen om de status van de regel te bepalen. In sommige weergave-hiërarchieën kan de onjuiste nabije 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, is ons Machine Learning-algoritme niet in staat om te detecteren of er tekst aanwezig is, dus wordt de kleurcontrastregel niet uitgevoerd op deze weergave.

Apps geschreven in XML die de hinttekstfunctie gebruiken, kunnen valse positieven zien bij de EditTextName regel. Hinttekst werd pas geïntroduceerd met Android 8 (SDK 26). Door dit element in uw XML-app te gebruiken, wordt de hinttekst toegewezen aan de waarde van het tekstinvoerveld. Nieuwere 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 om 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 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 tekstherkenning is vereist in veel van de axe DevTools Mobile regels om de nauwkeurigheid van de resultaten te waarborgen. De ML Kit-bibliotheek moet automatisch 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 op te lossen, moet u de ML Kit-bibliotheek handmatig in uw project importeren. In het bestand van uw applicatie build.gradle voegt u het volgende toe onder dependencies:

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

De aanraaktargetafstandregel wordt momenteel niet uitgevoerd op slidercomponenten die zijn geschreven in Jetpack Compose. Op dit moment kan er 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 permissiefout. 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'
//    finalizedBy {
//        fetchAndroidFolderAxeReportsTask
//    }
}

In sommige hybride en cross-platform apps kunnen we onverwachte resultaten teruggeven wanneer items in een scrollweergave gedeeltelijk van het scherm zijn. Om een element op toegankelijkheid te testen, zorgt u 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, 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 testgegevens kunt gebruiken en op die manier beveiligingszorgen kunt wegnemen. 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, werkt u eventuele aanroepen naar de methode bij setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de getroffen activiteitsvensters.

Om de volledige functionaliteit van axe DevTools voor mobiele apparaten te ontgrendelen, moet u ervoor zorgen dat schermafbeeldingen zijn ingeschakeld. We raden aan om schermafbeeldingen in te schakelen op een debug- of testversie van uw app die gebruikmaakt van gesimuleerde gegevens om beveiligingszorgen te voorkomen. Bekijk onze gids voor schermafbeeldingen inschakelen in Android-apps.

Als u uw build minimaliseert, ziet u een crash met een foutlogboek waarin wordt gemeld dat een adapter niet kan worden gevonden bij een poging om in te loggen bij de axe DevTools-bibliotheek. Schakel minimalisatie 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 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 de lay-outagnostische API's om updates te blijven ontvangen. Als u de Compose API's blijft gebruiken en een fout tegenkomt zoals `Exact '1' node verwacht maar '2' nodes gevonden die voldoen aan: (isRoot)` of `Geen View geïnitialiseerd, heeft u AxeDevToolsCompose.setComposeTestRule() aangeroepen?`, raadpleeg dan Compose setTestTag API.

Als u dit bericht tegenkomt, kunnen sommige regelresultaten niet terugkeren zoals verwacht wanneer die regel gebruikmaakt van kunstmatige intelligentie. Getroffen regels zijn onder andere Kleurcontrast, Focusbare Tekst en Geneste Elementnaam. (#841)

Vanwege beperkingen van de MAUI-apparchitectuur in het Android-ecosysteem zal de Edit Text Name-regel als Beoordeling Nodig verschijnen op het dashboard wanneer een falen wordt vermoed voor SDK-versie 5.5.0 en hoger. Controleer voor dit geval handmatig of het gedrag correct is.

Wanneer u aangepaste dialogen of modals implementeert die niet de native bedieningselementen uitbreiden, kunt u resultaten krijgen voor weergaven achter de modal. In dit geval raden we aan onze tool niet uit te voeren op deze aangepaste modals of dialogen en in plaats daarvan handmatig te controleren of ze met ondersteunende technologie naar wens functioneren.

Als de screenshot ontbreekt op de pagina met scantdetails, kan het zijn dat je app voorkomt dat er screenshots worden gemaakt. Vaak is dit om veiligheidsredenen in je productie-applicatie. Overweeg 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 gebruiken, zullen verschijnen als de volledige klassennaam inclusief de bundelidentifier. In een toekomstige release zal dit worden opgelost zodat de schermtitel wordt geformatteerd in een leesbaardere naam. Als tijdelijke oplossing kun je de scannaam instellen vanuit het dashboard of frameworks. (#1643)