Axe DevTools Mobile Release-opmerkingen van 16 september 2026

Als je Xcode 27 gebruikt en een Mobile Analyzer Desktop-app ouder dan 2.0.0 uitvoert, kan de app de iOS-simulator niet openen. Het mislukt bij het starten van /Applications/Xcode.app/Contents/Developer/Applications/Simulator.app Je kunt geen scan op basis van de simulator starten totdat dit is opgelost.

Om scans uit te voeren met behulp van een simulator op Xcode 27, update de Desktop Analyzer naar versie 2.0.0+. Met deze update zijn toegankelijkheidsresultaten nu te vinden in Axe Developer Hub.

De Axe DevTools SDK maakt gebruik van Apple's Vision-framework om tekst van het scherm te lezen voor verschillende toegankelijkheidsregels (bijv. Kleurencontrast, Kolliderende Weergaven, elke regel die afhankelijk is van door Vision gedetecteerde tekst).

Vision geeft niet altijd dezelfde gedetecteerde tekst terug tussen uitvoeringen van hetzelfde scherm. Wanneer Vision de tekst op een controle mist, zullen regels die van die tekst afhankelijk zijn niet worden uitgevoerd voor dat element bij die scan. Bevindingen kunnen inconsistent lijken tussen twee scans van hetzelfde scherm - een probleem dat faalt bij de ene scan kan afwezig zijn bij de volgende.

Wanneer een op Vision gebaseerde regel een mislukking rapporteert, is de mislukking zelf accuraat. De inconsistentie zit in het al dan niet uitvoeren van de regel. Om dit probleem te overwinnen, probeer het volgende:

• Voer de scan opnieuw uit. Als een op Vision gebaseerde regel werd overgeslagen voor een controle, wordt deze vaak bij een andere scan van hetzelfde scherm opgepikt.
• Behandel elke op Vision gebaseerde regelmislukking als geldig - als Kleurencontrast een controle markeert, is het contrastprobleem echt en moet het worden aangepakt.
• Gebruik voor handmatige verificatie de Deque University-referentie voor het relevante WCAG-succescriterium. (Links zijn te vinden onderaan elke regelpagina.)

Op iOS 26 en later, als een scherm tekst met een procentteken bevat (bijv. een tekstlabel met de tekst "50% Korting"), kan de Ondersteunt Dynamische Type-regel als Onvolledig worden gerapporteerd in plaats van als geslaagd of mislukt. Deze regel is afhankelijk van een toegankelijkheidsaudit die door Apple wordt geleverd, en die audit stopt de testrun wanneer het procenttekens tegenkomt. Om uw tests te laten doorgaan, slaat onze regel de controle voor dat scherm over en rapporteert onvolledig voor elk element dat een procentteken bevat. Alle andere regels worden normaal uitgevoerd op het scherm en andere schermen worden niet beïnvloed.

Er is geen actie vereist, aangezien uw scan nog steeds wordt voltooid. Om de ondersteuning van Dynamische Type op deze schermen te controleren, vergroot u de tekstgrootte op uw apparaat onder **Instellingen** > **Toegankelijkheid** > **Weergave & Tekstgrootte** > **Grote Tekst**, en bevestigt u dat de tekst op het scherm juist schaalt. Dit probleem is gemeld bij Apple. (#2985)

De Kleurencontrastregel maakt gebruik van Apple's Vision-framework (Optical Character Recognition, of OCR) om tekst binnen de grenzen van een element te lezen. OCR kan af en toe kleine, icoonachtige glyphs - zoals terug-pijlchevrons (<), opsommingstekens, decoratieve symbolen - verkeerd identificeren als tekst. Wanneer dat gebeurt, wordt de Kleurencontrastregel uitgevoerd op een element dat geen leesbare tekst bevat, wat een resultaat kan opleveren voor een knop die alleen een icoon bevat. Omdat de OCR-uitvoer niet deterministisch is tussen scans, kan hetzelfde element in de kleurencontrastresultaten van de ene scan verschijnen en als "NIET VAN TOEPASSING" worden gerapporteerd bij de volgende. Dit is een bekend kenmerk van OCR, geen fout in de regel.

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

Flutter map niet AppBar.title naar de native schermtitel-eigenschap - UIViewController.title, waardoor de Schermtitelregel mislukt op alle Flutter-schermen, ongeacht of er een beschrijvende titel aanwezig is.

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

Bij het uitvoeren van toegankelijkheidscontroles op kleinere schermformaten of met kleinere lettergroottes, kan de Kleurencontrastregel valse positieven rapporteren voor gradientachtergronden. In dergelijke gevallen is het mogelijk dat de voorgrondkleur niet kan worden bepaald en worden in plaats daarvan achtergrondkleuren met elkaar vergeleken, wat resulteert in een fout.

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 Kleurencontrast handmatig voor deze weergaven te controleren.

De toegankelijkheids-API's van Apple kunnen ten onrechte webinhoud binnen WKWebView als "isVisible", zelfs wanneer de webweergave wordt bedekt door native overlays (zoals modaalweergaven, waarschuwingen of andere native UI-elementen). Dit gebeurt omdat het toegankelijkheidssysteem controleert of de WKWebView-container zelf zichtbaar is, in plaats van of zijn webinhoud daadwerkelijk onbelemmerd en waarneembaar is voor de gebruiker.

iOS 26 bevat een toegankelijkheidsbug waarbij standaard stepper-knoppen niet "gedimd" aankondigen via Assistive Technology om aan te geven dat ze niet zijn ingeschakeld. Als gevolg hiervan 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 stepper-knoppen: AssociatedText, InaccessibleAction, en ColorContrast.

Totdat Apple deze bug oplost, is de oplossing om [de regels te negeren](ios-ignore-rule). De standaard stepper-knoppen hebben de identificaties "Decrement" en "Increment", 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 valse positieven rapporteren met LabelInName en LabelAtFront vanwege een onjuiste associatedText-eigenschap die wordt gevonden (#1622)

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

In UIKit-apps is een afbeelding zonder een `accessibilityLabel` niet focusbaar met assistive technology standaard.
De eigenschappen die we gebruiken om focusbaarheid te controleren van Apple kunnen onnauwkeurig zijn wanneer een `accessibilityIdentifier` is ingesteld op de afbeelding. Vanwege dit onverwachte gedrag zullen resultaten voor ImageView Name problemen in UIKit-apps worden gerapporteerd als Moet Beoordeeld Worden. Er is een bugrapport ingediend bij Apple. (#1633)

We werken actief aan oplossingen voor de volgende valse positieven en zullen deze lijst bijwerken zodra oplossingen zijn uitgebracht.

In Scroll View
Tekst binnen banner-gedrag elementen, plakkerige headers/voetteksten, zwevende actieknoppen en aangepaste tabweergaven kunnen worden gemarkeerd met een "Moet Beoordeeld Worden" of "Mislukt" bericht. 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 maar niet focusbaar is door VoiceOver, en het heeft focusbare controles genest binnenin, kan Active Control Name een vals positief rapporteren 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 besturingselement tussen nabije elementen om de status van de regel te bepalen. In sommige weergavehiërarchieën kan de verkeerde nabije tekst worden gedetecteerd, waardoor deze regels falen. (#1622)

De regel 'Label vooraan' controleert of het zichtbare label van een element aan het begin van de aangekondigde tekst komt. Een regelmisser kan optreden wanneer de zichtbare tekst van een interactief element een afkorting bevat (bijv. "GB", "km") of een verduisterde/verkleinde identificatie, en de toegankelijkheidsaankondiging bestaat uit de vertegenwoordigde woorden (bijv. "gigabytes", "kilometers"), ook al is dit het aanbevolen patroon om afgekorte of verkleinde inhoud toegankelijk te maken voor schermlezers.

Als het eerste deel van het zichtbare label van een interactief element overeenkomt met het begin van de schermlezer-aankondiging en alleen het verkorte/verduisterde gedeelte verschilt, kan het gemarkeerde resultaat veilig worden genegeerd. Controleer met een schermlezer of de volledige aankondiging wordt gelezen zoals bedoeld.

Bij het gebruik van decoratieve tekst in weergaven zoals "Contacticonen" is het mogelijk om een toegankelijkheidsprobleem te introduceren. Als je een tekstweergave gebruikt om letters weer te geven in plaats van afbeeldingen te genereren met de gewenste letters als vectoren, en je verklaart dan dat die tekstweergave niet belangrijk is voor toegankelijkheid, kunnen we niet betrouwbaar vaststellen of je een toegankelijkheidsschending hebt geïntroduceerd.

Als je focusbare tekst bewerkt om twee of minder tekens te negeren, kun je per ongeluk veel eenwoordknoppen in verschillende talen negeren (bijv. "OK", "Nee", "Sí"). Om deze problemen te vermijden, moet je de gewenste letters uit het woord dat je in het pictogram wilt vertegenwoordigen pakken en de letters genereren als deel van de afbeelding in plaats van als afzonderlijke tekstweergaven. `FocusableText` zal dan niet op die weergaven draaien.

Flutter map niet AppBar.title naar de native schermtitel-eigenschap - Activity.setTitle, waardoor de Schermtitelregel mislukt op alle Flutter-schermen, ongeacht of er een beschrijvende titel aanwezig is.

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

In sommige gevallen vertrouwt assistentietechnologie op AccessibilityEvent beschrijvingen van het Android-systeem om informatie aan de gebruiker aan te kondigen wanneer geen andere aankondiging beschikbaar is. Aangezien AccessibilityEventdoor gebruikersacties worden geactiveerd, kunnen we niet de juiste beschrijving verkrijgen als deze informatie niet wordt verstrekt.

Om dit probleem te vermijden, zorg ervoor dat alle relevante weergaven als belangrijk voor toegankelijkheid worden gemarkeerd. Hierdoor kan Talkback de informatie van de weergave verkrijgen, die onze tool vervolgens kan detecteren.

Onze Kleurencontrastregel is afhankelijk van Machine Learning om tekst te detecteren, wat ervoor zorgt dat de gescande tekst zichtbaar is voor gebruikers van uw toepassing. In gevallen waarin de tekst in een weergave dezelfde kleur heeft als de achtergrond, kan ons Machine Learning-algoritme niet vaststellen of er tekst aanwezig is, waardoor de Kleurencontrastregel voor deze weergave niet wordt uitgevoerd.

Apps geschreven met XML die de hinttekstfunctie gebruiken, kunnen foutieve positieven zien bij de EditTextName regel. Hinttekst werd pas geïntroduceerd bij Android 8 (SDK 26). Het gebruik van dit element in je XML-app zal de hinttekst toewijzen aan de waarde van het tekstinvoerveld. Recentere versies van Android zijn beter uitgerust om deze ervaring toegankelijk te maken.

Om dit probleem te overkomen, raden we aan je tests uit te voeren op nieuwere versies van Android. Als het echter belangrijk is dat de app toegankelijk is op eerdere Android-versies, kun je overwegen het gebruik van de hintText functie te vermijden, omdat deze officieel niet wordt ondersteund.

Je kunt resultaten zien voor weergaven die achter andere weergaven op het scherm verborgen zijn. Deze verborgen weergaven zijn niet beschikbaar voor assistentietechnologie, maar Axe DevTools Mobile rapporteert ze alsnog als problemen.

We werken aan een oplossing voor dit complexe probleem. In de tussentijd, als TalkBack deze weergaven niet kan bereiken, kun je de overeenkomstige 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 garanderen. De ML Kit-bibliotheek zou automatisch moeten worden geïmporteerd wanneer je verwijst naar Axe DevTools Mobile in je geautomatiseerde Espresso- of UIAutomator-testen. In sommige gevallen gebeurt de automatische import echter niet en zie je de volgende foutmelding in de logcat:

De regel voor aanraakdoelafstand wordt momenteel niet toegepast op schuifcomponenten die zijn geschreven in Jetpack Compose. Er kan op dit moment geen actie worden ondernomen. Er komt echter snel een oplossing!

Op Android API 30 heeft een van de locaties waar we proberen de 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 worden onderdrukt door de code in het volgende blok te becommentariëren:

In sommige hybride en cross-platform apps kunnen we onverwachte resultaten retourneren wanneer items in een scrollweergave gedeeltelijk buiten het scherm zijn. Om een element op toegankelijkheid te testen, zorg ervoor dat het volledig op het scherm staat voordat je de scan uitvoert.

Met API 31 (Android 12) is 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 je hebt gekozen om deze functie te gebruiken vanwege de verbeterde beveiliging, raden we aan deze uit te laten voor interne testbuilds waar je veilig testgegevens kunt gebruiken 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, update alle aanroepen naar de methode setHideOverlayWindows(true) naar setHideOverlayWindows(false) op de getroffen activiteitvensters.

Om de volledige functionaliteit van Axe DevTools voor Mobile 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 gebruikmaakt van mock-gegevens om beveiligingsproblemen te voorkomen. Bekijk onze gids voor inschakelen van screenshots in Android-apps.

Als je je build minificeert, zie je een crash met een foutrapport dat meldt dat er geen adapter kon worden gevonden wanneer je probeert in te loggen bij de Axe DevTools-bibliotheek. Schakel minificatie uit voor je debug-builds met Axe DevTools geïmplementeerd. (#729)

Een build met r8 ingeschakeld kan proberen de axeDevTools-bibliotheek te minificeren, wat resulteert in een fout die vergelijkbaar is met:

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 `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` of `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, raadpleeg dan de Compose setTestTag API.

Vanwege beperkingen in de MAUI-app-architectuur die rendert in het Android-ecosysteem, zal de regel voor naam bewerken van tekst als Beoordeling Nodig worden weergegeven in het dashboard wanneer een fout wordt vermoed voor SDK-versie 5.5.0 en hoger. Bevestig alstublieft handmatig het correcte gedrag voor dit geval.

Wanneer u aangepaste dialogen of modals implementeert die niet de standaardbesturingselementen 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 ze handmatig te controleren om te verzekeren dat ze correct functioneren met hulpmiddelen voor toegankelijkheid.

Als de screenshot ontbreekt op de pagina met scangegevens, kan het zijn dat uw app voorkomt dat screenshots worden gemaakt. Dit is vaak om veiligheidsredenen in uw productieapplicatie. Overweeg om deze vereiste voor uw testbuild te verwijderen om volledige functionaliteit in het Axe DevTools Mobile Dashboard mogelijk te maken.

• Android - FLAG_SECURE

Sommige Android-scan-namen die standaard worden ingesteld op de schermtitel, worden weergegeven als de volledige klasnaam inclusief de bundelidentifier. In een toekomstige release zal dit worden opgelost zodat de schermtitel wordt opgemaakt tot een beter leesbare naam. Als tijdelijke oplossing kunt u de scan-naam instellen vanuit het dashboard of frameworks. (#1643)