Axe DevTools Mobile Augustus 2026 Release-opmerkingen

Op iOS 26 en later, als een scherm tekst met een procentteken bevat (bijvoorbeeld een tekstlabel dat "50% Korting" leest), kan de Supports Dynamic Type-regel als Onvolledig worden gerapporteerd in plaats van een pass of fail. Deze regel vertrouwt op een toegankelijkheidsaudit die door Apple wordt geleverd, en die audit stopt de testuitvoering wanneer deze procenttekens tegenkomt. Om uw tests te laten doorgaan slaat onze regel de controle voor dat scherm over en rapporteert onvolledig voor elk element met een procentteken. Alle andere regels draaien normaal op het scherm, en andere schermen worden niet beïnvloed.

Er is geen actie vereist, aangezien uw scan nog steeds wordt voltooid. Om de Dynamic Type-ondersteuning voor deze schermen te controleren, verhoog de tekstgrootte op uw apparaat onder **Instellingen** > **Toegankelijkheid** > **Weergave & Tekstgrootte** > **Grote tekst**, en bevestig dat de tekst op het scherm zich correct aanpast. Dit probleem is gemeld aan Apple. (#2985)

De Kleurcontrast-regel gebruikt Apple's Vision-framework (Optische Tekenherkenning, of OCR) om tekst binnen de grenzen van een element te lezen. OCR kan soms kleine, op iconen lijkende tekens - zoals terug-pijlvormige chevrons (<), opsommingstekens, decoratieve symbolen - als tekst misidentificeren. Wanneer dat gebeurt, draait de Kleurcontrast-regel op een element dat geen leesbare tekst bevat, wat een resultaat voor een alleen-icoonknop kan opleveren. Omdat OCR-uitvoer niet deterministisch is over scans, kan hetzelfde element in de Kleurcontrast-resultaten verschijnen in de ene scan en worden gerapporteerd als "NIET TOEPASSELIJK" in de volgende. Dit is een bekende eigenschap van OCR, geen fout in de regel.

Om dit probleem te omzeilen, kunt u de ignore API's gebruiken om Kleurcontrast-resultaten voor de getroffen elementen te onderdrukken.

Flutter wijst niet toe AppBar.title aan de native schermtitel eigenschap - UIViewController.title, waardoor de Schermtitel-regel faalt op alle Flutter-schermen, ongeacht of er een beschrijvende titel aanwezig is.

Dit is een bekende Flutter-platformbeperking gevolgd in flutter/flutter#185894.

Bij het uitvoeren van toegankelijkheidscontroles op kleinere schermformaten of met kleinere lettergroottes kan de Kleurcontrast-regel valse positieve resultaten geven voor verloopachtergronden. In dergelijke gevallen kan het niet in staat zijn om de voorgrondkleur te bepalen en in plaats daarvan achtergrondkleuren met elkaar vergelijken, wat in een fout kan resulteren.

Om dit probleem te omzeilen, probeer toegankelijkheidscontroles uit te voeren op grotere apparaten. U kunt er ook voor kiezen om de regel in uw tests te negeren en Kleurcontrast handmatig voor deze weergaven te controleren.

De toegankelijkheids-API's van Apple kunnen webinhoud binnen WKWebView onjuist rapporteren als „isVisible“, zelfs wanneer de webweergave is bedekt door native overlays (zoals modale vensters, meldingen of andere native UI-elementen). Dit gebeurt omdat het toegankelijkheidssysteem controleert of de WKWebView-container zelf zichtbaar is, in plaats van of de webinhoud daadwerkelijk onbelemmerd en waarneembaar is voor de gebruiker.

iOS 26 bevat een toegankelijkheidsbug waarbij standaard stapknoppen niet „dimmed“ aankondigen via assistieve technologie om aan te geven dat ze niet zijn ingeschakeld. Hierdoor zien de iOS-regels deze knoppen ook als ingeschakeld, zelfs als ze dat niet zijn. Er is een bugrapport ingediend bij Apple, maar totdat dit is opgelost, kunnen de volgende regels resultaten rapporteren op uitgeschakelde stapknoppen: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze bug oplost, zal de oplossing zijn om [de regels te negeren](ios-ignore-rule). De standaard stapknoppen hebben de identificatie „Decrease“ en „Increase“ en kunnen indien nodig worden genegeerd op basis van identificatie.

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.

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

Bij het zoeken naar een verbetering voor onze regels ontdekten we dat in XCTest geneste bedieningselementen niet worden geretourneerd in de toegankelijkheidsboom. Er is een bugrapport ingediend bij Apple. (#1110)

In UIKit-apps is een afbeelding zonder een `accessibilityLabel` standaard niet focusbaar met assistieve technologie.
De eigenschappen die we gebruiken om de focuserbaarheid 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 zijn actief bezig met het oplossen van de volgende false positives en zullen deze lijst bijwerken zodra oplossingen zijn vrijgegeven.

In Scroll View
Tekst binnen elementen die zich als een banner gedragen, vaste headers/footers, zwevende actieknoppen en aangepaste tabweergaven kunnen worden gemarkeerd met het bericht „Beoordeling Nodig“ of „Falen“. Om deze elementen beschikbaar te maken voor degenen die grotere tekst nodig hebben, gebruik UILargeContentViewer. (#622, #2077)

v2.11.0 Image View Name & Active Control Name
Als een UIImageView een accessibilityIdentifier heeft ingesteld maar niet focusbaar is door VoiceOver, en er binnen de afbeelding focusbare bedieningselementen zijn genest, kan Active Control Name een false positive rapporteren op de UIImageView. Het verwijderen van de accessibilityIdentifier lost het probleem op. Er is een bugrapport ingediend 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 weergavehiërarchieën kan de onjuiste nabijgelegen tekst worden gedetecteerd, wat ertoe kan leiden dat deze regels falen. (#1622)

De regel Label at Front controleert of het zichtbare label van een element aan het begin van de aangekondigde tekst komt. Een regelmislukking kan optreden wanneer de zichtbare tekst van een interactief element een afkorting (bijv. „GB“, „km“) of een verduisterde/afgekorte identificatie bevat, en de toegankelijkheidsaankondiging bestaat uit de vertegenwoordigde woorden (bijv. „gigabytes“, „kilometers“), hoewel dit het aanbevolen patroon is om afgekorte of afgekorte inhoud schermlezer-vriendelijk te maken.

Als het eerste deel van het zichtbare label van een interactief element overeenkomt met het begin van de schermlezer-aankondiging en alleen het afgekorte/verduisterde gedeelte verschilt, kan het gemarkeerde resultaat veilig worden genegeerd. Verifieer met een schermlezer dat de volledige aankondiging naar wens wordt gelezen.

Bij het gebruik van decoratieve tekst in weergaven zoals „Contactpictogrammen“, is het mogelijk om een toegankelijkheidsprobleem te introduceren. Als u een tekstweergave gebruikt om letters weer te geven in plaats van afbeeldingen te genereren met de gewenste letters als vectoren, en u vervolgens verklaart dat die tekstweergave niet belangrijk is voor toegankelijkheid, zullen we niet betrouwbaar kunnen zien of u een toegangsprobleem heeft geïntroduceerd.

Als u focusbare tekst bewerkt om twee of minder tekens te negeren, kunt u mogelijk per ongeluk veel een-woordknoppen in verschillende talen negeren (bijv. „OK“, „Nee“, „Sí“). Om deze problemen te vermijden, moet u de gewenste letters uit het woord dat u in het pictogram wilt weergeven, halen en de letters als onderdeel van de afbeelding genereren in plaats van als afzonderlijke tekstweergaven. `FocusableText` zal dan niet worden uitgevoerd op die weergaven.

Flutter koppelt niet AppBar.title aan de native schermtitels-eigenschap - Activity.setTitle, waardoor de Schermtitelregel faalt op alle Flutter-schermen, ongeacht of er een beschrijvende titel aanwezig is.

Dit is een bekende Flutter platformbeperking, bijgehouden in flutter/flutter#185894.

In sommige gevallen vertrouwt assistieve technologie op AccessibilityEvent omschrijvingen van het Android-systeem om informatie aan de gebruiker aan te kondigen wanneer er geen andere aankondiging beschikbaar is. Omdat AccessibilityEvents worden geactiveerd door gebruikersacties, kunnen we niet toegang krijgen tot de juiste beschrijving als deze informatie niet wordt verstrekt.

Om dit probleem te voorkomen, moet u ervoor zorgen dat alle relevante weergaven als belangrijk voor toegankelijkheid zijn gemarkeerd. Hierdoor kan Talkback de informatie van de weergave ophalen, die onze tool dan kan detecteren.

Onze kleurcontrastregel is afhankelijk van machine learning om tekst te detecteren, wat ervoor zorgt dat de gescande tekst zichtbaar is voor de gebruikers van uw applicatie. In gevallen waarin de tekst binnen een weergave dezelfde kleur heeft als de achtergrond, kan ons machine learning-algoritme niet detecteren of er enige tekst aanwezig is, waardoor de kleurcontrastregel niet op deze weergave wordt uitgevoerd.

Apps geschreven met XML die de hinttekstfunctie gebruiken, kunnen false positives zien met de EditTextName regel. Hinttekst werd pas geïntroduceerd in Android 8 (SDK 26). Gebruik van dit element in uw XML-app zal de hinttekst toekennen aan de waarde van het tekstinvoerveld. Meer recente versies van Android zijn beter uitgerust om deze ervaring toegankelijk te maken.

Om dit probleem op te lossen, is onze eerste aanbeveling om uw tests op nieuwere versies van Android te draaien. 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 resultaten te waarborgen. De ML Kit-bibliotheek moet automatisch worden geïmporteerd bij het refereren aan Axe DevTools Mobile in uw geautomatiseerde Espresso- of UIAutomator-tests. In sommige gevallen echter, vindt de automatische import niet plaats en ziet u de volgende fout in de logcat:

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

Op Android API 30 is er een toestemmingsfout bij een van de locaties waar we proberen resultaten lokaal op te slaan. 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 sluiten:

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 te testen op toegankelijkheid, zorg ervoor dat het volledig in beeld is voordat de scan wordt uitgevoerd.

Met API 31 (Android 12) werd 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 u ervoor heeft gekozen om deze functie te gebruiken vanwege de verbeterde beveiliging, raden we aan deze uit te laten voor interne testbuilds waar u veilig testgegevens kunt gebruiken en beveiligingszorgen 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, werkt u alle aanroepen naar de methode bij setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de beïnvloede activiteitsvensters.

Om de volledige functionaliteit van Axe DevTools voor mobiel te ontgrendelen, zorg ervoor dat schermafbeeldingen zijn ingeschakeld. We raden aan schermafbeeldingen in te schakelen in een debug- of testversie van uw app die mockgegevens gebruikt om beveiligingszorgen te vermijden. Bekijk onze gids voor het inschakelen van schermafbeeldingen in Android-apps.

Als u uw build minimaliseert, ziet u een crash met een foutlog dat meldt dat een adapter niet kon worden gevonden bij het proberen in te loggen op de Axe DevTools-bibliotheek. Schakel minimalisering uit voor je debug-builds met geïmplementeerde Axe DevTools. (#729)

Een build met ingeschakelde r8 kan proberen de axeDevTools-bibliotheek te minimaliseren, wat resulteert in een foutmelding zoals:

De Compose API's zijn verouderd, gebruik alstublieft de lay-out agnostische API's om updates te blijven ontvangen. Als u 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 Compose setTestTag API.

Vanwege beperkingen van de MAUI-apparchitectuur in het Android-ecosysteem, zal de regel voor het bewerken van tekstnaam worden vermeld als Behoeft Beoordeling in het dashboard wanneer een falen wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig voor dit geval handmatig het correcte gedrag.

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

Als de schermafbeelding ontbreekt op de scandetailspagina, voorkomt uw app mogelijk dat er schermafbeeldingen worden gemaakt. Vaak gebeurt dit om veiligheidsredenen in uw productieapplicatie. Overweeg om deze vereiste te verwijderen voor uw testbuild om volledige functionaliteit in het Axe DevTools Mobile Dashboard mogelijk te maken.

• Android - FLAG_SECURE

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