Note di rilascio di Axe DevTools Mobile agosto 2026

Su iOS 26 e versioni successive, se una schermata contiene testo con un segno di percentuale (ad esempio, un'etichetta di testo con scritto "50% di sconto"), la regola di supporto del tipo dinamico potrebbe risultare incompleta invece di superata o fallita. Questa regola si basa su un audit di accessibilità fornito da Apple, e tale audit interrompe il test quando incontra segni di percentuale. Per mantenere il tuo test in esecuzione, la nostra regola salta il controllo per quella schermata e riporta incompleta per ogni elemento contenente un segno di percentuale. Tutte le altre regole funzionano normalmente sulla schermata, e le altre schermate non sono influenzate.

Non è richiesto alcun intervento, poiché la scansione si completerà comunque. Per controllare il supporto del tipo dinamico per queste schermate, aumenta la dimensione del testo sul tuo dispositivo in **Impostazioni** > **Accessibilità** > **Schermo e testo** > **Testo grande**, e conferma che il testo sulla schermata si adatta appropriatamente. Questo problema è stato riportato ad Apple. (#2985)

La regola del Contrasto del colore utilizza il framework Vision di Apple (Optical Character Recognition, o OCR) per leggere il testo all'interno dei confini di un elemento. L'OCR può occasionalmente identificare erroneamente piccoli glifi simili a icone - come i chevron di freccia indietro (<), i punti elenco, i simboli decorativi - come testo. Quando ciò accade, la regola del Contrasto del colore si applica a un elemento che non contiene testo leggibile, il che può produrre un risultato per un pulsante costituito solo da icone. Poiché l'output dell'OCR non è deterministico tra le scansioni, lo stesso elemento potrebbe apparire nei risultati del Contrasto del colore in una scansione e risultare "NON APPLICABILE" nella successiva. Questo è una caratteristica nota dell'OCR, non un errore nella regola.

Per aggirare questo problema, puoi utilizzare le ignore API per sopprimere i risultati del Contrasto del colore per gli elementi interessati.

Flutter non mappa AppBar.title alla proprietà del titolo dello schermo nativo - UIViewController.title, causando il fallimento della regola del titolo dello schermo su tutte le schermate Flutter, indipendentemente dalla presenza di un titolo descrittivo.

Questa è una limitazione nota della piattaforma Flutter monitorata in flutter/flutter#185894.

Quando si eseguono controlli di accessibilità su schermi di piccole dimensioni o con caratteri di dimensioni ridotte, la regola del Contrasto del colore può riportare falsi positivi per sfondi a gradiente. In tali casi, può non essere in grado di determinare il colore in primo piano e invece confrontare i colori di sfondo tra loro, risultando in un fallimento.

Per aggirare questo problema, prova a eseguire controlli di accessibilità su dispositivi più grandi. In alternativa, puoi scegliere di ignorare la regola nei tuoi test e controllare manualmente il Contrasto del colore per queste visualizzazioni.

Le API di accessibilità di Apple possono segnalare erroneamente il contenuto web all'interno di WKWebView come "isVisible", anche quando la web view è coperta da sovrapposizioni native (come viste modali, avvisi o altri elementi dell'interfaccia utente nativa). Ciò si verifica perché il sistema di accessibilità verifica se il contenitore di WKWebView è visibile, piuttosto che se il suo contenuto web è effettivamente non ostruito e percepibile dall'utente.

iOS 26 contiene un bug di accessibilità in cui i pulsanti stepper predefiniti non annunciano "disattivato" tramite la Tecnologia Assistiva per indicare che non sono abilitati. Di conseguenza, le regole di iOS vedono questi pulsanti come abilitati anche se non lo sono. È stato presentato un rapporto di bug ad Apple, ma fino a quando questo non sarà risolto, le seguenti regole potrebbero riportare risultati sui pulsanti stepper disattivati: AssociatedText, InaccessibleAction, e ColorContrast.

Fino a quando Apple non correggerà questo bug, la soluzione sarà [ignorare le regole](ios-ignore-rule). I pulsanti stepper predefiniti hanno gli identificatori "Decrement" e "Increment", e possono essere ignorati per identificatore se necessario.

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.

Alcune schermate possono riportare falsi positivi con LabelInName e LabelAtFront a causa di una proprietà associatedText errata rilevata (#1622)

Mentre esaminavamo un miglioramento per le nostre regole, abbiamo scoperto che in XCTest i controlli annidati non vengono restituiti nell'albero di accessibilità. È stato depositato un rapporto di bug ad Apple. (#1110)

Nelle app UIKit, un'immagine senza un `accessibilityLabel` non è focalizzabile con la tecnologia assistiva di default.
Le proprietà che utilizziamo per verificare la focalizzabilità da Apple possono essere imprecise quando su un'immagine è impostato un `accessibilityIdentifier`. A causa di questo comportamento inaspettato, i risultati relativi ai problemi del nome del ImageView nelle app UIKit saranno riportati come Needs Review. È stato presentato un rapporto di bug ad Apple. (#1633)

Stiamo lavorando attivamente a correzioni per i seguenti falsi positivi e aggiorneremo questo elenco man mano che le correzioni verranno rilasciate.

In Scroll View
Il testo all'interno di elementi con comportamento da banner, intestazioni/piè di pagina adesivi, pulsanti di azione flottanti e viste a schede personalizzate può essere contrassegnato con un messaggio di "Needs Review" o "Fail". Per rendere questi elementi disponibili a coloro che richiedono testo più grande, utilizzare UILargeContentViewer. (#622, #2077)

v2.11.0 Image View Name & Active Control Name
Se un UIImageView ha un accessibilityIdentifier impostato ma non è focalizzabile con VoiceOver, e ha controlli focalizzabili annidati al suo interno, Active Control Name potrebbe segnalare un falso positivo sull'UIImageView. Rimuovendo il accessibilityIdentifier si risolve il problema. È stato depositato un rapporto di bug ad Apple. (#1633)

Label In Name and Label At Front
Queste due regole cercano l'etichetta visibile di un controllo tra gli elementi vicini per aiutare a determinare lo stato della regola. In alcune gerarchie di vista, potrebbe essere rilevato il testo sbagliato nelle vicinanze, causando il fallimento di queste regole. (#1622)

La regola Label at Front verifica che l'etichetta visibile di un elemento sia all'inizio del suo testo annunciato. Un fallimento della regola può verificarsi quando il testo visibile di un elemento interattivo contiene un'abbreviazione (es. "GB", "km") o un identificatore oscurato/troncato, e l'annuncio di accessibilità si compone delle parole rappresentate (es. "gigabyte", "chilometri"), anche se questo è il modello raccomandato per rendere il contenuto abbreviato o troncato compatibile con i lettori di schermo.

Se la prima parte dell'etichetta visibile di un elemento interattivo corrisponde all'inizio dell'annuncio del lettore di schermo e solo la parte abbreviata/oscurata è diversa, il risultato segnalato può essere tranquillamente ignorato. Verificate con un lettore di schermo che l'annuncio completo venga letto come previsto.

Quando si utilizzano testi decorativi in viste come "Icone di Contatto", è possibile introdurre un problema di accessibilità. Se si utilizza una vista di testo per visualizzare lettere anziché generare immagini con le lettere desiderate come vettori, e poi si dichiara che tale vista di testo non è importante per l'accessibilità, non saremo in grado di determinare con certezza se avete introdotto una violazione dell'accessibilità.

Se modificate il testo focalizzabile per ignorare due o meno caratteri, potreste involontariamente ignorare molti pulsanti a una parola in varie lingue (es. "OK", "No", "Sí"). Per evitare questi problemi, dovreste prendere le lettere desiderate dalla parola che volete rappresentare nell'icona e generare le lettere come parte dell'immagine anziché come viste di testo separate. `FocusableText` non verrà quindi eseguito su quelle viste.

Flutter non mappa AppBar.title alla proprietà del titolo della schermata nativa - Activity.setTitle, causando il fallimento della regola del titolo della schermata su tutte le schermate Flutter indipendentemente dalla presenza di un titolo descrittivo.

Questa è una limitazione nota della piattaforma Flutter segnalata in flutter/flutter#185894.

In alcuni casi, la tecnologia assistiva si basa su AccessibilityEvent delle descrizioni di sistema Android per annunciare informazioni all'utente quando nessun altro annuncio è disponibile. Poiché AccessibilityEventvengono attivati da azioni dell'utente, non siamo in grado di accedere alla descrizione corretta se queste informazioni non sono fornite.

Per evitare questo problema, assicuratevi che tutte le viste rilevanti siano contrassegnate come importanti per l'accessibilità. Questo permetterà a Talkback di accedere alle informazioni dalla vista, che il nostro strumento potrà quindi rilevare.

La nostra regola sul contrasto di colore dipende dall'Apprendimento Automatico per rilevare il testo, il che garantisce che il testo analizzato sia visibile agli utenti della vostra applicazione. Nei casi in cui il testo contenuto in una vista è dello stesso colore dello sfondo, il nostro algoritmo di Apprendimento Automatico non è in grado di rilevare se è presente del testo, quindi la regola di contrasto di colore non viene eseguita su questa vista.

Le app scritte con XML che utilizzano la funzione di testo di suggerimento possono vedere falsi positivi con la EditTextName regola. Il testo di suggerimento non è stato introdotto fino ad Android 8 (SDK 26). Utilizzando questo elemento nella vostra app XML verrà assegnato il testo di suggerimento al valore del campo di input. Le versioni più recenti di Android sono meglio attrezzate per rendere questa esperienza accessibile.

Per superare questo problema, la nostra prima raccomandazione è di eseguire i test su versioni più recenti di Android. Tuttavia, se è importante che l'app sia accessibile su versioni precedenti di Android, potresti considerare di evitare l'uso della funzionalità hintText , poiché non è ufficialmente supportata.

Potresti vedere risultati per viste che sono nascoste dietro altre viste sullo schermo. Queste viste nascoste non sono disponibili per la tecnologia assistiva, ma Axe DevTools Mobile le riporta comunque come problemi.

Stiamo lavorando a una soluzione per questo problema complesso. Nel frattempo, se TalkBack non riesce a raggiungere queste viste, puoi ignorare i problemi corrispondenti. Non richiedono una soluzione per garantire l'accessibilità.

Il rilevamento di testo di ML Kit è richiesto in molte regole di Axe DevTools Mobile per garantire l'accuratezza dei risultati. La libreria ML Kit dovrebbe essere automaticamente importata quando si fa riferimento a Axe DevTools Mobile nei test automatici di Espresso o UIAutomator. In alcuni casi, tuttavia, l'importazione automatica non avviene e vedrai il seguente errore nel logcat:

La regola di spaziare il target di tocco attualmente non viene eseguita su alcun componente slider scritto in Jetpack Compose. Al momento, non è possibile intraprendere alcuna azione. Tuttavia, è in arrivo una soluzione!

Su Android API 30, una delle posizioni in cui tentiamo di salvare i risultati localmente genera un errore di permessi. Il risultato verrà comunque salvato come file JSON nonostante venga visualizzato questo errore. L'errore può essere soppresso commentando il codice nel blocco seguente:

In alcune app ibride e cross-platform, potremmo restituire risultati inaspettati quando gli elementi in una vista a scorrimento sono parzialmente fuori dallo schermo. Per testare un elemento per l'accessibilità, assicurati che sia completamente sullo schermo prima di eseguire la scansione.

Introdotta con API 31 (Android 12) è la capacità di nascondere le sovrapposizioni non di sistema. Per utilizzare l'app Axe Analyzer, assicurati che questa impostazione non sia attivata. Se hai scelto di utilizzare questa funzione per i suoi miglioramenti alla sicurezza, ti consigliamo di lasciarla disattivata per le build di test interne dove puoi utilizzare i dati di test in sicurezza ed eliminare in questo modo le preoccupazioni per la sicurezza. Note: this setting does not affect Google's accessibility scanner app as it's considered a system overlay.

Per utilizzare l'app Axe Accessibility Analyzer, aggiorna tutte le chiamate al metodo setHideOverlayWindows(true) sull'attività interessata. setHideOverlayWindows(false) nei finestrini dell'attività interessata.

Per sbloccare la piena funzionalità di Axe DevTools per Mobile, assicurati che gli screenshot siano abilitati. Si consiglia di abilitare gli screenshot su una versione di debug o test della tua app che utilizza dati simulati per evitare problemi di sicurezza. Consulta la nostra guida per abilitare gli screenshot nelle app Android.

Se minimizzi la tua build, vedrai un arresto anomalo con un errore nel log che segnala che un adattatore non è stato trovato quando si tenta di accedere alla libreria Axe DevTools. Disabilita il minify per le tue build di debug con Axe DevTools implementato. (#729)

Una build con r8 abilitato può tentare di minimizzare la libreria axeDevTools, risultando in un errore simile a:

Le API Compose sono deprecate, ti invitiamo a utilizzare le API indipendenti dal layout per continuare a ricevere aggiornamenti. Se continui a utilizzare le API Compose e incontri un errore simile a `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` o `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, fai riferimento a API Compose setTestTag.

A causa delle limitazioni dell'architettura dell'app MAUI nel sistema Android, la regola Nome Testo Modifica verrà mostrata come Da revisionare nella dashboard quando si sospetta un errore per la versione SDK 5.5.0 e successive. Si prega di confermare manualmente il comportamento corretto per questo caso.

Quando implementi dialoghi o modali personalizzati che non estendono i controlli nativi, potresti ricevere risultati per le viste dietro al modale. In questo caso, raccomandiamo di non eseguire il nostro strumento contro questi dialoghi o modali personalizzati e invece verificare manualmente che si comportino come desiderato con la tecnologia assistiva.

Se lo screenshot manca dalla pagina dei dettagli della scansione, la tua app potrebbe impedire la cattura degli screenshot. Spesso ciò avviene per motivi di sicurezza nella tua applicazione di produzione. Considera la possibilità di rimuovere questo requisito per la tua build di test per consentire la piena funzionalità nella Dashboard di Axe DevTools Mobile.

• Android - FLAG_SECURE

Alcuni nomi di scansioni Android che sono predefiniti come titolo dello schermo appariranno come nome completo della classe inclusa l'identificativo del pacchetto. In una versione futura, questo verrà risolto in modo che il titolo dello schermo sia formattato in un nome più leggibile. Come soluzione temporanea, puoi impostare il nome della scansione dalla dashboard o dai framework. (#1643)