Note di rilascio di Axe DevTools Mobile del 26 novembre 2025

Le API di accessibilità di Apple possono riportare 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 UI nativi). Questo accade perché il sistema di accessibilità verifica se il contenitore WKWebView stesso è 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 "oscurato" tramite la Tecnologia Assistiva per indicare che non sono abilitati. Di conseguenza, le regole di iOS vedono anche questi pulsanti come abilitati, anche se non lo sono. È stato presentato un bug report ad Apple, ma finché questo non sarà risolto, le seguenti regole potrebbero riportare risultati su pulsanti stepper disabilitati: AssociatedText, InaccessibleAction, e ColorContrast.

Fino a quando Apple non risolve questo bug, la risoluzione 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.

Un'impostazione di configurazione in iOS Analyzer 1.4.7 impedisce l'esecuzione delle scansioni, restituendo il messaggio "Test fallito". Per eseguire scansioni su un dispositivo fisico, aggiorna al progetto iOS Analyzer più recente.

La funzionalità del test di un'applicazione per identificatore di pacchetto è stata interrotta nella versione 2.8.1, il che ha portato a un errore intitolato "No target application path specified via test configuration: ...". Aggiorna alla versione 2.8.2 o alla più recente per risolvere l'errore. Aggiorna all'interno del progetto iOS Analyzer all'ultima versione.

La scansione di alcune applicazioni con questa versione del progetto anlyzer e dell'SDK comporterebbe un "Could not Serialize AxeResult" errore. Aggiorna alla versione più recente per risolvere l'errore. Aggiorna al progetto iOS Analyzer più recente.Aggiorna all'ultima SDK di iOS.

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

C'è un problema che riguarda il simulatore di iPhone 15 Pro che impedisce il funzionamento della regola Supports Dynamic Type. Se hai aderito alla regola Supports Dynamic Type, non potrai testarla utilizzando un simulatore iPhone 15 Pro. È stato segnalato un bug ad Apple.

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

Nelle app UIKit, un'immagine senza un accessibilityLabel non è focalizzabile con la tecnologia assistiva per impostazione predefinita.
Le proprietà che utilizziamo per controllare la focalizzabilità da Apple possono essere inaccurate quando un accessibilityIdentifier è impostato sull'immagine. A causa di questo comportamento imprevisto, i risultati delle problematiche del nome di ImageView nelle app UIKit saranno segnalati come Revisione Necessaria. È stato segnalato un bug ad Apple. (#1633)

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

In Scroll View
Possono segnalare problemi per il testo all'interno di elementi che si comportano come banner. Per rendere questi elementi disponibili a chi necessita di testo più grande, utilizza UILargeContentViewer. (#622)

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 nidificati al suo interno, ActiveControlName potrebbe segnalare un falso positivo su UIImageView. Rimuovendo il accessibilityIdentifier risolve il problema. È stato segnalato un bug ad Apple. (#1633)

Label In Name and Label At Front
Queste due regole cercano l'etichetta visibile di un controllo tra elementi vicini per aiutare a 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 nostra regola del Contrasto di Colore dipende dal Machine Learning per rilevare il testo, garantendo che il testo sottoposto a scansione sia visibile agli utenti della tua applicazione. Nei casi in cui il testo contenuto in una vista ha lo stesso colore dello sfondo, il nostro algoritmo di Machine Learning non è in grado di rilevare se è presente del testo, quindi la regola del Contrasto di Colore non viene eseguita su questa vista.

Le app scritte con XML che utilizzano la funzione del testo suggerito possono vedere falsi positivi con la EditTextName regola. Il testo suggerito è stato introdotto solo con Android 8 (SDK 26). L'utilizzo di questo elemento nella tua app XML assegnerà il testo suggerito al valore del campo di input del testo. 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 tuoi test su versioni più recenti di Android. Se è importante che l'app sia accessibile su versioni precedenti di Android, 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 riporta comunque come problemi.

Stiamo lavorando su una soluzione per questo problema complesso. Nel frattempo, se TalkBack non può raggiungere queste viste, puoi ignorare i problemi corrispondenti. 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 importata automaticamente quando si fa riferimento ad Axe DevTools Mobile nei tuoi test automatici di Espresso o UIAutomator. In alcuni casi, tuttavia, l'importazione automatica non avviene e vedrai il seguente errore nel logcat:

Per superare questo problema, dovresti importare manualmente la libreria ML Kit nel tuo progetto. Nel tuo build.gradle file dell'applicazione, aggiungi quanto segue sotto le dipendenze:

La regola di Spaziatura dei Bersagli Tattili attualmente non funziona su componenti slider scritti in Jetpack Compose. Non si può intraprendere alcuna azione al momento. Tuttavia, una correzione è in arrivo!

Su Android API 30, una delle posizioni in cui tentiamo di salvare i risultati localmente presenta un errore di autorizzazioni. Il risultato verrà comunque salvato come file JSON nonostante venga visualizzato questo errore. L'errore può essere soppresso commentando il codice nel seguente blocco:
def clearDirectoryTask = task('clearDirectoryTask', type: Exec, group: 'reporting') {
executable "${android.getAdbExecutable().toString()}"
args 'shell', 'rm', '-r', '/storage/emulated/0/Documents/AxeTestCases'
// finalizedBy {
// fetchAndroidFolderAxeReportsTask
// }
}

Si prega di notare che questo codice dovrebbe essere commentato solo per API 30 poiché causerà problemi quando si salva localmente per altri livelli API.

In alcune app ibride e multipiattaforma, potremmo restituire risultati inattesi quando gli elementi in una vista di 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 funzionalità per i suoi miglioramenti alla sicurezza, ti consigliamo di lasciarla disattivata per le build di test interni dove puoi utilizzare in sicurezza i dati di test e eliminare le preoccupazioni di sicurezza in questo modo. 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) a setHideOverlayWindows(false) nelle finestre delle attività interessate.

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

Se si riduce al minimo il build, si verificherà un arresto anomalo con un log di errore che segnala che un adattatore non può essere trovato quando si tenta di accedere alla libreria Axe DevTools. Disattivare la minimizzazione per i build di debug con Axe DevTools implementato. (#729)

Un build con r8 abilitato potrebbe tentare di minimizzare la libreria axeDevTools causando un errore simile a:
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)
Per risolvere questo errore, aggiungere la seguente riga al file ProGuard per mantenere le classi axeDevTools:
keep class com.deque.** { *; }

Le API di Compose sono deprecate, si prega di usare le API indipendenti dal layout per continuare a ricevere aggiornamenti. Se si continua a utilizzare le API di Compose e si riscontra un errore del tipo `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` o `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, si prega di consultare Compose setTestTag API.

Se si incontra questo messaggio, alcuni risultati delle regole potrebbero non restituire il previsto quando quella regola utilizza l'intelligenza artificiale. Le regole interessate includono Contrasto del colore, Testo focalizzabile e Nome dell'elemento nidificato. (#841)

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

Quando si implementano dialoghi o modali personalizzati che non estendono i controlli nativi, si potrebbero ottenere risultati per le viste dietro al modale. In questo caso, consigliamo di non eseguire il nostro strumento contro questi modali o dialoghi personalizzati e anziché questo controllarli manualmente per garantire che si comportino con la tecnologia assistiva come desiderato.

Se lo screenshot manca dalla pagina dei dettagli di scansione, la tua app potrebbe impedire che vengano scattati screenshot. Spesso ciò avviene per motivi di sicurezza nella tua applicazione di produzione. Considera l'idea di rimuovere questo requisito per il tuo build di test per consentire la piena funzionalità nel Dashboard Mobile di Axe DevTools.

• Android - FLAG_SECURE

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