Note di rilascio di Axe DevTools Mobile del 16 settembre 2026

Se stai usando Xcode 27 e eseguendo un'app Desktop Analyzer Mobile più vecchia della versione 2.0.0, l'app non può aprire il simulatore iOS. Fallisce quando prova a lanciare /Applications/Xcode.app/Contents/Developer/Applications/Simulator.app Non puoi avviare una scansione basata sul simulatore finché questo non viene risolto.

Per eseguire scansioni utilizzando un simulatore su Xcode 27, aggiorna Desktop Analyzer alla versione 2.0.0+. Con questo aggiornamento, tieni presente che i risultati di accessibilità sono ora disponibili in Axe Developer Hub.

L'SDK Axe DevTools utilizza il framework Vision di Apple per leggere il testo dallo schermo per diverse regole di accessibilità (ad es. Contrasto Colore, Visualizzazioni in Collisione, qualsiasi regola che dipende dal testo rilevato da Vision).

Vision non restituisce sempre lo stesso testo rilevato tra esecuzioni dello stesso schermo. Quando Vision non rileva il testo su un controllo, le regole che dipendono da quel testo non verranno eseguite per quell'elemento in quella scansione. I risultati possono apparire incoerenti tra due scansioni dello stesso schermo - un problema che si verifica in una scansione potrebbe essere assente nella successiva.

Quando una regola basata su Vision segnala un errore, l'errore stesso è accurato. L'incoerenza sta nel fatto che la regola venga eseguita o meno. Per superare questo problema, prova quanto segue:

• Ripeti la scansione. Se una regola basata su Vision è stata saltata per un controllo, un'altra scansione dello stesso schermo spesso la rileva.
• Tratta qualsiasi errore di regola basata su Vision come valido - se Contrasto Colore segnala un controllo, il problema di contrasto è reale e deve essere risolto.
• Per la verifica manuale, utilizza il riferimento di Deque University per il criterio di successo WCAG pertinente. (I link si trovano in fondo a ciascuna pagina delle regole.)

Su iOS 26 e versioni successive, se uno schermo contiene testo con un segno percentuale (ad es. un'etichetta di testo che legge "50% di Sconto"), la regola Supporta Tipo Dinamico potrebbe segnalare come Incompleta anziché con un esito positivo o negativo. Questa regola si basa su un audit di accessibilità fornito da Apple, e quell'audit interrompe l'esecuzione del test quando incontra segni percentuali. Per mantenere il test in corso, la nostra regola salta il controllo per quello schermo e segnala incompleto per ogni elemento contenente un segno percentuale. Tutte le altre regole vengono eseguite normalmente sullo schermo, e altri schermi non sono influenzati.

Non è richiesta nessuna azione, poiché la tua scansione verrà comunque completata. Per verificare il supporto al Tipo Dinamico per questi schermi, aumenta la dimensione del testo sul tuo dispositivo andando su **Impostazioni** > **Accessibilità** > **Display e Dimensione Testo** > **Testo Grande**, e conferma che il testo sullo schermo si adatti in modo appropriato. Questo problema è stato segnalato ad Apple. (#2985)

La regola Contrasto Colore utilizza il framework Vision di Apple (Riconoscimento Ottico dei Caratteri, o OCR) per leggere il testo all'interno dei confini di un elemento. OCR può occasionalmente identificare erroneamente piccoli glifi simili a icone - come le chevron della freccia indietro (<), i punti elenco, i simboli decorativi - come testo. Quando ciò accade, la regola Contrasto Colore viene eseguita su un elemento che non contiene testo leggibile, il che può produrre un risultato per un pulsante con sola icona. Poiché l'output dell'OCR non è deterministico tra le scansioni, lo stesso elemento può apparire nei risultati di Contrasto Colore in una scansione e essere riportato come "NON APPLICABILE" nella successiva. Questa è una caratteristica nota dell'OCR, non un bug nella regola.

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

Flutter non mappa AppBar.title alla proprietà del titolo dello schermo nativo - UIViewController.title, causando il fallimento della regola Titolo Schermo su tutti gli schermi Flutter indipendentemente dal fatto che sia presente un titolo descrittivo.

Questo è un problema noto della piattaforma Flutter, tracciato in flutter/flutter#185894.

Quando si eseguono controlli di accessibilità su dimensioni di schermo più piccole o con dimensioni di carattere ridotte, la regola Contrasto Colore potrebbe segnalare falsi positivi per sfondi sfumati. In tali casi, potrebbe non essere in grado di determinare il colore di primo piano e confrontare invece i colori di sfondo tra loro, risultando in un errore.

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

Le API di accessibilità di Apple possono riportare erroneamente il contenuto web all'interno di WKWebView come "isVisible", anche quando la vista web è coperta da sovrapposizioni native (come visualizzazioni modali, avvisi o altri elementi UI nativi). Ciò accade perché il sistema di accessibilità verifica se il contenitore WKWebView è visibile, piuttosto che se il suo contenuto web è effettivamente non ostruito e percepibile per l'utente.

iOS 26 contiene un bug di accessibilità per cui i pulsanti stepper predefiniti non annunciavano "attenuato" dalla tecnologia assistiva per indicare che non sono abilitati. Di conseguenza, anche le regole iOS vedono questi pulsanti come abilitati, anche se non lo sono. Un report di bug è stato inviato ad Apple, ma finché questo non viene risolto, le seguenti regole potrebbero riportare risultati su pulsanti stepper disabilitati: AssociatedText, InaccessibleAction, e ColorContrast.

Fino a quando Apple non risolve questo bug, la soluzione sarà [ignorare le regole](ios-ignore-rule). I pulsanti stepper predefiniti hanno gli identificatori "Diminuisci" e "Aumenta", 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.

Alcuni schermi possono segnalare falsi positivi con LabelInName e LabelAtFront a causa di una proprietà associatedText trovata in modo errato (#1622)

Durante l'esame di un miglioramento per le nostre regole, abbiamo scoperto che in XCTest, i controlli annidati non vengono restituiti nell'albero dell'accessibilità. È stato inviato un bug ad Apple. (#1110)

Nelle app UIKit, un'immagine senza un `accessibilityLabel` non è focalizzabile con tecnologia assistiva per impostazione predefinita.
Le proprietà che utilizziamo per verificare la focalizzabilità da Apple potrebbero essere inaccurate quando un `accessibilityIdentifier` è impostato sull'immagine. A causa di questo comportamento inatteso, i risultati per i problemi di Nome ImageView nelle app UIKit verranno segnalati come Richiede Revisione. È stato inviato un report di bug ad Apple. (#1633)

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

In Scroll View
Il testo all'interno di elementi con comportamento banner, intestazioni/piè di pagina fissi, pulsanti di azione flottanti e visualizzazioni di schede personalizzate possono essere segnalati con un messaggio "Richiede Revisione" o "Errore". Per rendere questi elementi accessibili a chi richiede un testo più grande, utilizza UILargeContentViewer. (#622, #2077)

v2.11.0 Image View Name & Active Control Name
Se un UIImageView ha un accessibilityIdentifier impostato ma non è focalizzabile da VoiceOver, e ha controlli focalizzabili annidati al suo interno, Active Control Name può segnalare un falso positivo su UIImageView. Rimuovere il accessibilityIdentifier risolve il problema. Un bug è stato segnalato 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 determinare lo stato della regola. In alcune gerarchie di visualizzazione, il testo vicino errato può essere rilevato causando il fallimento di queste regole. (#1622)

La regola dell'Etichetta Frontale 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 (ad es. "GB", "km") o un identificatore oscurato/troncato, e l'annuncio di accessibilità consiste nelle parole rappresentate (ad es. "gigabyte", "chilometri"), anche se questo è il modello raccomandato per rendere il contenuto abbreviato o troncato accessibile ai 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. Verificare con un lettore di schermo che l'annuncio completo sia letto come previsto.

Quando si utilizza testo decorativo in viste come "Icone dei Contatti", è possibile introdurre un problema di accessibilità. Se si utilizza una vista testo per visualizzare lettere invece di generare immagini con le lettere desiderate come vettori, e si dichiara poi che tale vista testo non è importante per l'accessibilità, non saremo in grado di determinare in modo affidabile se avete introdotto una violazione di accessibilità.

Se modificate il testo focalizzabile per ignorare due o meno caratteri, potreste involontariamente ignorare molti pulsanti mono-parola in varie lingue (ad 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 invece che come viste testo separate. `FocusableText` non verrà quindi eseguito su tali viste.

Flutter non mappa AppBar.title alla proprietà del titolo dello schermo nativo - Activity.setTitle, causando il fallimento della regola Titolo Schermo su tutti gli schermi Flutter indipendentemente dal fatto che sia presente un titolo descrittivo.

Questo è un problema noto della piattaforma Flutter, tracciato in flutter/flutter#185894.

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

Per evitare questo problema, assicurati 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 può quindi rilevare.

La nostra regola Contrasto Colore dipende dall'apprendimento automatico per rilevare il testo, il che garantisce che il testo scansionato sia visibile agli utenti della tua applicazione. Nei casi in cui il testo contenuto in una vista sia dello stesso colore dello sfondo, il nostro algoritmo di apprendimento automatico non è in grado di rilevare se il testo è presente, quindi la regola Contrasto Colore non viene eseguita su questa vista.

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

Per superare questo problema, la nostra prima raccomandazione è eseguire i test su versioni più recenti di Android. Se è importante che l'app sia accessibile su versioni precedenti di Android, tuttavia, potresti considerare di evitare l'uso della hintText funzione, 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 segnala comunque come problemi.

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

Il rilevamento del testo di ML Kit è richiesto in molte delle 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 tuoi test automatizzati Espresso o UIAutomator. Tuttavia, in alcuni casi, l'importazione automatica non accade e vedrai il seguente errore nel logcat:

La regola della Spaziatura del Bersaglio Tattile non è attualmente in esecuzione su nessun componente slider scritto in Jetpack Compose. Al momento non è possibile intraprendere alcuna azione. Tuttavia, una soluzione arriverà presto!

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

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

Introdotta con API 31 (Android 12) è la possibilità di nascondere 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 versioni di test interno dove puoi utilizzare in sicurezza i dati di test ed eliminare così le preoccupazioni di 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 qualsiasi chiamata al metodo setHideOverlayWindows(true) a setHideOverlayWindows(false) sulle finestre delle attività interessate.

Per sbloccare la piena funzionalità di Axe DevTools per Mobile, assicurati che le schermate siano abilitate. Raccomandiamo di abilitare le schermate in una versione di debug o test della tua app che utilizza dati mock per evitare problemi di sicurezza. Consulta la nostra guida per abilitare le schermate nelle app Android.

Se minimizzi il tuo build, vedrai un crash con un log di errore che segnala che un adattatore non può essere trovato quando si tenta di accedere alla libreria Axe DevTools. Disattiva la minimizzazione per i tuoi 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, usa per favore le API indipendenti dal layout per continuare a ricevere aggiornamenti. Se continui a utilizzare le API Compose e incontri un errore come `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` o `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, per favore riferisciti a Compose setTestTag API.

A causa di limitazioni dell'architettura delle app MAUI nel rendering nell'ecosistema Android, la regola per il nome del campo di testo editabile verrà mostrata come Revisionare nel dashboard quando si sospetta un errore per la versione SDK 5.5.0 e successive. Per favore, conferma manualmente il comportamento corretto per questo caso.

Quando implementi dialoghi o modali personalizzati che non estendono i controlli nativi, potresti ottenere risultati per le visualizzazioni dietro il modale. In questo caso, raccomandiamo di non eseguire il nostro strumento su questi modali o dialoghi personalizzati, ma di controllarli manualmente per assicurarti che si comportino come desiderato con la tecnologia assistiva.

Se lo screenshot è mancante dalla pagina dei dettagli della scansione, la tua app potrebbe impedire che gli screenshot vengano scattati. Spesso ciò avviene per ragioni di sicurezza nella tua applicazione in produzione. Considera di rimuovere questo requisito per la tua build di test per consentire la piena funzionalità nel Dashboard Mobile di Axe DevTools.

• Android - FLAG_SECURE

Alcuni nomi di scansione Android che predefiniti al titolo dello schermo appariranno come il nome completo della classe incluso l'identificatore del pacchetto. In un prossimo rilascio, questo sarà risolto in modo che il titolo dello schermo sia formattato in un nome più leggibile. Come soluzione alternativa, puoi impostare il nome della scansione dal dashboard o dai framework. (#1643)