Axe DevTools Mobile Note di rilascio del 6 novembre 2025

Le API di accessibilità di Apple possono riportare erroneamente i contenuti web all'interno di WKWebView come "isVisible", anche quando la web view è coperta da overlay nativi (come visualizzazioni modali, avvisi o altri elementi UI nativi). Questo accade perché il sistema di accessibilità verifica se il contenitore di WKWebView è visibile, piuttosto che controllare se il suo contenuto web sia effettivamente non ostruito e percepibile dall'utente.

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

Fino a quando Apple non risolverà questo bug, la soluzione sarà di [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.

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

La funzionalità di testare un'applicazione tramite l'identificatore del bundle è stata interrotta nella versione 2.8.1, il che ha causato un errore intitolato "No target application path specified via test configuration: ...". Aggiorna alla versione 2.8.2 o a quella più recente per risolvere l'errore. Aggiorna all'ultima versione tra i progetti di iOS Analyzer.

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

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

C'è un problema che interessa il simulatore di iPhone 15 Pro che impedisce alla regola Supporta Tipo Dinamico di funzionare. Se hai sottoscritto la regola Supporta Tipo Dinamico, non potrai testarla utilizzando il simulatore di iPhone 15 Pro. È stato inviato un bug ad Apple.

Durante l'esame di un miglioramento per le nostre regole, abbiamo scoperto che in XCTest, i controlli annidati non vengono restituiti nell'albero di accessibilità. È stato inviato un 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 inaccurate quando un accessibilityIdentifier è impostato sull'immagine. A causa di questo comportamento inaspettato, i risultati per i problemi di NomeView Immagine nelle app UIKit saranno segnalati come Da Revisionare. È stato inviato un report di bug ad Apple. (#1633)

Stiamo lavorando attivamente su correggere i seguenti falsi positivi e aggiorneremo questa lista non appena le correzioni saranno rilasciate.

In Scroll View
Può segnalare problemi per il testo all'interno di elementi che si comportano come banner. Per rendere questi elementi disponibili a chi richiede 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 contiene controlli focalizzabili annidati al suo interno, NomeControlloAttivo può riportare un falso positivo sull'UIImageView. Rimuovendo il accessibilityIdentifier risolve il problema. È stato inviato un 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 determinare lo stato della regola. In alcune gerarchie di visualizzazione, il testo vicino potrebbe essere rilevato in modo errato causando il fallimento di queste regole. (#1622)

La nostra regola del contrasto dei colori dipende dal Machine Learning per rilevare il testo, il che assicura che il testo scansionato sia visibile agli utenti della tua applicazione. Nei casi in cui il testo contenuto in una vista abbia lo stesso colore dello sfondo, il nostro algoritmo di Machine Learning non riesce a rilevare se è presente del testo, quindi la regola del contrasto dei colori non si avvia su questa vista.

Le app scritte con XML che utilizzano la funzione di suggerimento del testo possono mostrare falsi positivi con la EditTextName regola. Il testo di suggerimento non è stato introdotto fino a Android 8 (SDK 26). Usare questo elemento nella tua app XML assegnerà il testo di suggerimento al valore del campo di input del testo. Le versioni più recenti di Android sono meglio equipaggiate 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 hintText funzione, poiché non è ufficialmente supportata.

Potresti vedere risultati per viste che sono nascoste dietro altre viste sullo schermo. Queste viste nascoste non sono accessibili alla tecnologia assistiva, ma Axe DevTools Mobile continua a segnalarle come problematiche.

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

Il rilevamento testi 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 a Axe DevTools Mobile nei tuoi test automatizzati di Espresso o UIAutomator. Tuttavia, in alcuni casi, 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 build.gradle file della tua applicazione, aggiungi quanto segue sotto dipendenze:

La regola della Spaziatura del bersaglio tattile attualmente non viene eseguita su alcun componente slider scritto in Jetpack Compose. Nessuna azione può essere intrapresa al momento. Tuttavia, una soluzione è in arrivo!

Su Android API 30, una delle posizioni in cui tentiamo di salvare i risultati localmente presenta 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 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 in quanto causerà problemi quando si salva localmente per altri livelli API.

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

Introdotta con API 31 (Android 12) è la capacità di nascondere sovrapposizioni non di sistema. Per usufruire dell'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 i build di test interni dove puoi utilizzare dati di test in sicurezza ed eliminare i problemi 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 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 gli screenshot siano abilitati. Raccomandiamo di abilitare gli screenshot su una versione di debug o test della tua app che utilizza dati fittizi per evitare problemi di sicurezza. Consulta la nostra guida per abilitare gli screenshot nelle app Android.

Se si riduce il build, vedrai un crash con un log di errore che segnala che un adattatore non può essere trovato quando si cerca di accedere alla libreria Axe DevTools. Disabilita la minimizzazione per i tuoi build di debug con Axe DevTools implementato. (#729)

Un build con r8 abilitato può tentare di ridurre la libreria axeDevTools, generando 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 aggiungi la seguente riga al tuo file ProGuard per mantenere le classi axeDevTools:
keep class com.deque.** { *; }

Le API Compose sono deprecate, si prega di utilizzare le API agnostiche di layout per continuare a ricevere aggiornamenti. Se continui a utilizzare le API Compose e incontri un errore del tipo «Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)» o «No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?», consulta la API setTestTag di Compose.

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

A causa delle limitazioni dell'architettura delle app MAUI in esecuzione nell'ecosistema Android, la regola Nome Testo Modificabile verrà mostrata come da Rivedere nel 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 ottenere risultati per le viste dietro il modale. In questo caso, consigliamo di non eseguire il nostro strumento contro questi modali o dialoghi personalizzati e di controllarli manualmente per assicurarsi che funzionino come desiderato con le tecnologie assistive.

Se il screenshot manca dalla pagina dei dettagli della scansione, la tua app potrebbe impedire la cattura di screenshot. Spesso ciò avviene per motivi 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 sono impostati di default al titolo della schermata appariranno come il nome completo della classe, incluso l'identificatore del bundle. In un rilascio futuro, questo sarà risolto in modo che il titolo della schermata sia formattato in un nome più leggibile. Come soluzione temporanea, puoi impostare il nome della scansione dal dashboard o dai framework. (#1643)