axe DevTools Mobile Release-opmerkingen 16 januari 2025

Functionaliteit met het testen van een applicatie door bundel-ID was gebroken in versie 2.8.1, wat resulteerde in een fout met de titel „Geen doelapplicatiepad opgegeven via testconfiguratie: ...“. Update naar 2.8.2 of de laatste versie om de fout te verhelpen. Update naar de nieuwste binnen het iOS Analyzer-project.

Sommige schermen kunnen valse positieven rapporteren met LabelInName en LabelAtFront vanwege een onjuiste associatedText-eigenschap die wordt gevonden (#1622)

Er is een probleem dat de iPhone 15 Pro-simulator beïnvloedt, waardoor de regel Ondersteunt Dynamisch Type niet kan worden uitgevoerd. Als u bent ingeschreven voor de regel Ondersteunt Dynamisch Type, kunt u deze niet testen met een iPhone 15 Pro-simulator. Er is een bug ingediend bij Apple.

Bij 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` niet standaard focusbaar met ondersteunende technologie.
De eigenschappen die we gebruiken om focusbaarheid vanaf Apple te controleren, kunnen onnauwkeurig zijn wanneer een `accessibilityIdentifier` op de afbeelding is ingesteld. Vanwege dit onverwachte gedrag worden resultaten voor problemen met de ImageView Naam in UIKit-apps gerapporteerd als Beoordeling Nodig. Er is een bugrapport ingediend bij Apple. (#1633)

We werken actief aan oplossingen voor de volgende valse positieve meldingen en zullen deze lijst bijwerken zodra oplossingen worden vrijgegeven.

In Scroll View
Kan problemen melden voor tekst binnen banners-functionerende elementen. 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 controles genest binnenin, kan ActieveBesturingselementNaam een vals positieve melden 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 regelstatus te helpen bepalen. In sommige weergavehiërarchieën kan de verkeerde nabijgelegen tekst worden gedetecteerd, waardoor deze regels falen. (#1622)

Op Android API 30 heeft een van de locaties waar we proberen resultaten lokaal op te slaan een permissiefout. Het resultaat wordt nog steeds als een JSON-bestand opgeslagen 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 buiten het scherm vallen. Om een element op toegankelijkheid te testen, zorg ervoor dat het volledig op het scherm staat vóór de scan.

Met API 31 (Android 12) is de mogelijkheid geïntroduceerd om niet-systeem overlay's te verbergen. Om de axe Analyzer-app te kunnen gebruiken, zorg ervoor dat deze instelling niet is ingeschakeld. Als u ervoor heeft gekozen om deze functie te gebruiken vanwege de verbeteringen op het gebied van beveiliging, raden we aan deze uit te laten voor interne test-builds waarbij u testen veilig kunt uitvoeren en zo 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, werk je alle aanroepen naar de methode bij setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de getroffen activiteitvensters.

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

Als je je build aan het verkleinen bent, krijg je een crash met een foutlog dat aangeeft dat een adapter niet kon worden gevonden bij het inloggen op de axe DevTools-bibliotheek. Schakel minify uit voor je debug-builds met geïmplementeerde axe DevTools. (#729)

Een build met r8 ingeschakeld kan proberen de axeDevTools-bibliotheek te verkleinen, wat resulteert in een foutmelding die lijkt op:

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 je doorgaat met het gebruik van de Compose API's en een fout tegenkomt zoals `Verwacht precies '1' node maar vond '2' nodes die voldoen aan: (isRoot)` of `Geen View geïnitialiseerd, heb je AxeDevToolsCompose.setComposeTestRule() aangeroepen?`, raadpleeg dan Compose setTestTag API.

Als je 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-app architectuur die rendert binnen het Android-ecosysteem, zal de regel Bewerken Tekstnaam als Moet worden beoordeeld worden weergegeven in het dashboard wanneer een fout 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 controls niet uitbreiden, kun je resultaten krijgen voor weergaven achter de modal. In dit geval raden we aan onze tool niet op deze aangepaste modals of dialogen te gebruiken en deze in plaats daarvan handmatig te controleren om ervoor te zorgen dat ze zich gedragen zoals gewenst met ondersteunende technologie.

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