axe DevTools Mobile 9 juli 2025 Releaseopmerkingen

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

De functionaliteit voor het testen van een applicatie door middel van bundle identifier was kapot in versie 2.8.1, wat resulteerde in een fout met de titel „Geen doeltoepadapplicatie gespecificeerd via testconfiguratie: ...“ Update naar 2.8.2 of de nieuwste versie om de fout op te lossen. Werk bij naar de nieuwste versie binnen het iOS Analyzer-project.

Het scannen van sommige applicaties met deze versie van de analyzer en SDK resulteerde in een „Kon AxeResult niet serialiseren“ fout. Update naar de nieuwste versie om de fout op te lossen. Werk het nieuwste iOS Analyzer-project bij.Werk de nieuwste iOS SDK bij.

Sommige schermen kunnen valse positieven melden met LabelInName en LabelAtFront vanwege een onjuist gevonden associatedText-eigenschap (#1622)

Er is een probleem dat de iPhone 15 Pro-simulator beïnvloedt waardoor de regel 'Dynamische typografie ondersteunen' niet wordt uitgevoerd. Als u bent ingeschreven voor de regel 'Dynamische typografie ondersteunen', kunt u deze niet testen met behulp van een iPhone 15 Pro-simulator. Er is een bug gemeld bij Apple.

Tijdens het kijken naar een verbetering voor onze regels hebben we ontdekt dat in XCTest geneste bedieningselementen niet worden weergegeven in de toegankelijkheidsstructuur. Er is een bug gemeld 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 kunnen onnauwkeurig zijn wanneer een `accessibilityIdentifier` op de afbeelding is ingesteld. Vanwege dit onverwachte gedrag zullen resultaten voor ImageView naamproblemen in UIKit-apps worden gerapporteerd als 'Beoordeling 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 fixes zijn vrijgegeven.

In Scroll View
Kan problemen melden voor tekst binnen banners die zich als elementen 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 bedieningselementen genest binnenin, kan ActiveControlName een vals positief resultaat melden op de UIImageView. Het verwijderen van de `accessibilityIdentifier` lost het probleem op. Er is een bug gemeld bij Apple. (#1633)

Label In Name and Label At Front
Deze twee regels zoeken naar het zichtbare label van een bedieningselement tussen nabijgelegen elementen om de status van de regel te helpen bepalen. In sommige weergave-hiërarchieën kan de verkeerde nabijgelegen tekst worden gedetecteerd, waardoor deze regels kunnen falen. (#1622)

Onze kleurcontrastregel is afhankelijk van machine learning om tekst te detecteren, wat ervoor zorgt dat de tekst die wordt gescand 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, zodat de kleurcontrastregel niet wordt uitgevoerd op deze weergave.

Apps geschreven met XML die de functie voor hinttekst gebruiken, kunnen valse waarschuwingen zien met de EditTextName regel. Hinttekst is niet geïntroduceerd tot Android 8 (SDK 26). Het gebruik van dit element in uw XML-app kent de hinttekst toe aan de waarde van het tekstinvoerveld. Meer recente 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 echter belangrijk is dat de app toegankelijk is op eerdere Android-versies, kunt u overwegen om het gebruik van de hintText functie te vermijden, 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 ondersteunende technologie, maar axe DevTools Mobile meldt 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 wordt automatisch 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 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 aan uw project toevoegen. 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 wordt momenteel niet uitgevoerd op schuifregelaarcomponenten die zijn geschreven in Jetpack Compose. Er kan op dit moment 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 toestemmingsfout. Het resultaat wordt nog steeds opgeslagen als een JSON-bestand, ondanks dat deze fout wordt weergegeven. De fout kan onderdrukt worden 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 teruggeven wanneer items in een scrollweergave gedeeltelijk buiten beeld zijn. Om een element te testen op toegankelijkheid, zorg 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 kunnen gebruiken, zorg ervoor dat deze instelling niet is ingeschakeld. Als u ervoor heeft gekozen om deze functie te gebruiken voor de veiligheidsverbeteringen, raden wij aan om deze uit te laten voor interne testversies waarin u veilig testgegevens kunt gebruiken 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, update alle aanroepen naar de methode setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de betrokken activiteitvensters.

Om volledige functionaliteit van axe DevTools voor Mobiel vrij te spelen, zorg ervoor dat schermafbeeldingen zijn ingeschakeld. We raden aan om schermafbeeldingen in te schakelen op een debug- of testversie van uw app die mockgegevens gebruikt om veiligheidsproblemen te vermijden. Lees onze gids voor het inschakelen van schermafbeeldingen in Android-apps.

Als u uw build verkleint, krijgt u een crash met een foutlog dat meldt dat een adapter niet kon worden gevonden bij het inloggen op de axe DevTools-bibliotheek. Schakel verkleinen uit voor uw debug-builds met geïmplementeerde axe DevTools. (#729)

Een build met r8 ingeschakeld kan proberen de axeDevTools-bibliotheek te verkleinen, 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 layout-agnostische 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 weergave geïnitialiseerd, heeft u AxeDevToolsCompose.setComposeTestRule() opgeroepen?`, raadpleeg dan alstublieft de Compose setTestTag API.

Als u dit bericht tegenkomt, kunnen sommige regelresultaten niet naar verwachting worden teruggegeven wanneer die regel kunstmatige intelligentie gebruikt. Getroffen regels zijn onder andere Kleurencontrast, Focusbare Tekst en Geneste Elementnaam. (#841)

Vanwege beperkingen van de MAUI-apparchitectuur in het Android-ecosysteem, wordt de Bewerken Tekst Naam regel weergegeven als Vereist Herziening in het dashboard wanneer een fout wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig alstublieft handmatig correct gedrag voor dit geval.

Wanneer u aangepaste dialogen of modals implementeert die de native controles niet uitbreiden, kunt u resultaten krijgen voor weergaven achter de modal. In dit geval raden we aan om onze tool niet te gebruiken voor deze aangepaste modals of dialogen en in plaats daarvan deze handmatig te controleren om ervoor te zorgen dat ze correct functioneren met ondersteunende technologie.

Als de schermafbeelding ontbreekt op de scan-detailpagina, kan uw app mogelijk voorkomen dat er schermafbeeldingen worden gemaakt. Vaak is dit om veiligheidsredenen in uw productieapplicatie. Overweeg deze vereiste te verwijderen voor uw test-build om volledige functionaliteit te verkrijgen in het axe DevTools Mobile Dashboard.

• Android - FLAG_SECURE

Sommige Android-scan namen die standaard op de schermtitel zijn ingesteld, verschijnen als de volledige class name inclusief de bundle identifier. In een toekomstige release zal dit worden opgelost zodat de schermtitel in een beter leesbare naam wordt omgezet. Als workaround kunt u de scan naam instellen vanuit het dashboard of frameworks. (#1643)