axe DevTools Mobile Releaseopmerkingen van 8 oktober 2024
8 oktober 2024
Componentversies
- Android SDK (axe-devtools-android v5.6.0)
- Android Analyzer (axe Accessibility Analyzer v1.9.0)
- Android Appium Driver (axe-appium-uiautomator2-driver v1.1.0)
Hoe te updaten: Android SDK, Android Analyzer Android Appium Driver
Wat is nieuw?
Inaccessible Action-regel
We hebben Inactive Accessible View hernoemd naar Inaccessible Action om overeen te komen met de naamgeving van de regel voor iOS. We hebben ook besloten om deze regel als experimenteel te markeren, zodat we de nauwkeurigheid van de resultaten voor beide platforms kunnen verbeteren.
Oplossingen
- Updates om de prestaties en nauwkeurigheid van de volgende regels te verbeteren: Kleurcontrast, Touch Target-grootte, Label in Naam, Label vooraan, Bewerken van Tekstnaam en Genest Actief Besturingselement
- Classnaam van overlappende view toegevoegd aan geanalyseerde waarden voor de Touch Target-afstandsregel om te helpen met foutopsporing
- Herziene resultaatsbeschrijvingen om meer beschrijvend te zijn en verbeterde richtlijnen te bieden over hoe problemen op te lossen voor de Inaccessible Action en Label vooraan regels
- Verbeterde stabiliteit en betrouwbaarheid van de toegankelijkheidsservice. De app zal niet langer elke keer dat deze wordt gebruikt opnieuw om machtigingen vragen
- Geoptimaliseerde netwerkaanvragen voor het uploaden van resultaten naar het dashboard
- Verbeterde foutafhandeling van authenticatie in de Appium Driver
Afschrijvingen
Na zorgvuldig overwegen, gaan we richting een gestroomlijnde implementatie van axe DevTools voor Android die zal resulteren in het afschrijven van de XML- en Compose-API's in de toekomst. Hoewel deze overgang niet van de ene op de andere dag zal plaatsvinden, moedigen we klanten aan om geleidelijk over te stappen naar de layout-onafhankelijke API's voor blijvende ondersteuning en toegang tot de nieuwste updates.
Bekende problemen
Als je een van de onderstaande problemen ervaart, neem dan contact met ons op via helpdesk@deque.com of support.deque.com. We kunnen je dan op de hoogte stellen zodra het is opgelost of over een geïdentificeerde oplossing als er geen wordt vermeld.
- axe DevTools Mobile geautomatiseerde tests worden uitgevoerd op native iOS-, native Android- en React Native-applicaties. Neem contact op met je Deque-vertegenwoordiger voor oplossingen voor toegankelijkheidstests op jouw technologie stack.
- Hoewel je mogelijk enkele resultaten krijgt van webviews of gerenderde PDF's, raden we aan om te testen met axe DevTools voor Web of axe Monitor voor de meest uitgebreide toegankelijkheidstests voor het web.
iOS
Fout in Analyzer Project & Testen op Bundle ID in 2.8.1
Functionaliteit met het testen van een applicatie op bundel-ID was kapot in versie 2.8.1 wat resulteerde in een fout met de titel „Geen doeltoepad opgegeven via testconfiguratie: ...“. Update naar 2.8.2 of de nieuwste versie om de fout op te lossen. Update naar de nieuwste binnen het iOS Analyzer-project.
Vals positief: LabelInName en LabelAtFront in SwiftUI & Cross Platform-apps
Sommige schermen kunnen valse positieven rapporteren met LabelInName en LabelAtFront vanwege een onjuist gevonden associatedText-eigenschap (#1622)
Geldt niet: Supports Dynamic Type-regel werkt niet met iOS 15 Pro simulator
Er is een probleem dat de iPhone 15 Pro simulator beïnvloedt en voorkomt dat de Supports Dynamic Type-regel wordt uitgevoerd. Als je bent ingeschreven voor de Supports Dynamic Type-regel, kun je deze niet testen met een iPhone 15 Pro simulator. Er is een bug gemeld bij Apple.
Regels tegen geneste besturingselementen
Bij het onderzoek naar een verbetering van onze regels ontdekten we dat in XCTest geneste besturingselementen niet worden geretourneerd in de toegankelijkheidsboom. Er is een bug gemeld bij Apple. (#1110)
ImageView Naamregel Moet Resultaten voor UIKit-apps Controleren
In UIKit-apps is een afbeelding zonder een `accessibilityLabel` standaard niet focusbaar met ondersteunende technologie.
De eigenschappen die we gebruiken om focusbaarheid te controleren van Apple kunnen onnauwkeurig zijn wanneer een `accessibilityIdentifier` is ingesteld op het beeld. Vanwege dit onverwachte gedrag zullen resultaten voor ImageView Naam-problemen in UIKit-apps worden gerapporteerd als Moet Worden Gecontroleerd. Er is een bugrapport ingediend bij Apple. (#1633)
Vals positief: In Scroll View, Label In Naam, Label vooraan en v2.11.0 Image View Naam & ActiefBesturingselementNaam
We werken actief aan oplossingen voor de volgende valse positieven en zullen deze lijst bijwerken zodra er oplossingen worden uitgebracht.
In Scroll View
Kan problemen melden voor tekst binnen elementen die zich als banner gedragen. Maak deze elementen beschikbaar 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 er focusbare elementen binnenin zitten, kan ActiveControlName een false positive rapporteren 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 het zichtbare label van een control tussen nabijgelegen elementen om de status van de regel te bepalen. In sommige weergavehiërarchieën kan de onjuiste nabije tekst worden gedetecteerd, waardoor deze regels falen. (#1622)
Android
Analyzer-app: zwevende actieknop verdwijnt
Met API 31 (Android 12) is de mogelijkheid geïntroduceerd om niet-systeem overlays 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 voor de beveiligingsverbeteringen, raden we aan deze uitgeschakeld te laten voor interne testversies waarin je veilig met testgegevens kunt werken 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, werk je alle aanroepen naar de methode setHideOverlayWindows(true) bij setHideOverlayWindows(false) op de getroffen activiteitsvensters.
Screenshot ontbreekt (zwarte doos) in het dashboard
Om de volledige functionaliteit van axe DevTools voor mobiel te ontgrendelen, zorg ervoor dat screenshots zijn ingeschakeld. We raden aan om screenshots in te schakelen op een debug- of testversie van je app die mockgegevens gebruikt om beveiligingsproblemen te vermijden. Bekijk onze gids voor het inschakelen van screenshots in Android-apps.
Crash wanneer `minifiedEnabled` is ingesteld op true
Als je je build verkleint, treedt er een crash op met een foutlogboek dat meldt dat een adapter niet kon worden gevonden tijdens het inloggen bij de axe DevTools-bibliotheek. Schakel minificatie uit voor je debug-builds met geïmplementeerde axe DevTools. (#729)
Builds met ingeschakelde r8 geven een fout
Een build met ingeschakelde r8 kan proberen de axeDevTools-bibliotheek te verkleinen, 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)
To resolve this error add the following line to your ProGuard file to keep axeDevTools classes:keep class com.deque.** { *; }
Foutmelding vergelijkbaar met:
Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)
of: No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?
De Compose API's zijn verouderd, gebruik alsjeblieft de lay-out agnostische API's om updates te blijven ontvangen. Als je 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 alsjeblieft de Compose setTestTag API.
Logbericht:MlKitContext has not been initialized
Als je dit bericht tegenkomt, kunnen sommige regelresultaten niet zoals verwacht retourneren wanneer die regel gebruikmaakt van kunstmatige intelligentie. Aangetaste regels zijn onder andere Kleurcontrast, Focusbare tekst en Genest elementnaam. (#841)
MAUI: Bewerken tekstnaam regel
Vanwege beperkingen van de MAUI-apparchitectuur in de Android-ecosysteem, zal de regel voor de bewerktekstnaam in het dashboard als Beoordeling vereist worden weergegeven wanneer een fout wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig in dit geval handmatig het juiste gedrag.
Native Android: Aangepaste dialogen/modals
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 te gebruiken voor deze aangepaste modals of dialogen, maar in plaats daarvan deze handmatig te controleren om ervoor te zorgen dat ze naar wens werken met ondersteunende technologie.
Webdashboard
Ontbrekende screenshot
Als de screenshot ontbreekt op de scandetailpagina, kan je app verhinderen dat er screenshots worden gemaakt. Vaak is dit om beveiligingsredenen in je productieapplicatie. Overweeg deze vereiste voor je testbuild te verwijderen om volledige functionaliteit in het axe DevTools Mobile Dashboard mogelijk te maken.
Sommige Android-scannamen zijn niet opgemaakt
Sommige Android-scannamen die standaard op de schermtitel zijn gebaseerd, zullen verschijnen als de volledige klassennaam inclusief de bundelidentifier. In een toekomstige release zal dit opgelost worden zodat de schermtitel in een beter leesbare naam wordt omgezet. Als workaround kun je de scannaam instellen vanuit het dashboard of frameworks. (#1643)
