Note di rilascio di Axe DevTools Mobile del 9 luglio 2025

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 configurazione nelle impostazioni di iOS Analyzer 1.4.7 impedisce l'esecuzione delle scansioni, restituendo il messaggio "Test Failed". Per eseguire scansioni su un dispositivo fisico, aggiorna al progetto iOS Analyzer più recente.

La funzionalità di test di un'applicazione tramite identificatore di bundle era malfunzionante nella versione 2.8.1, causando un errore intitolato "No target application path specified via test configuration: ...". Aggiorna alla versione 2.8.2 o alla versione più recente per risolvere l'errore. Aggiorna all'ultima versione all'interno del progetto iOS Analyzer.

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

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

C'è un problema che interessa il simulatore iPhone 15 Pro che impedisce l'esecuzione della regola del Supporto Tipo Dinamico. Se hai optato per la regola del Supporto Tipo Dinamico, non potrai testarla utilizzando un simulatore iPhone 15 Pro. Un bug è stato segnalato ad Apple.

Durante un miglioramento delle nostre regole, abbiamo scoperto che in XCTest, i controlli nidificati non vengono restituiti nell'albero di accessibilità. Un bug è stato segnalato ad Apple. (#1110)

Nelle app UIKit, un'immagine senza un `accessibilityLabel` non è di default focalizzabile con la tecnologia assistiva.
Le proprietà che utilizziamo per verificare la focalizzabilità da Apple possono essere imprecise quando un `accessibilityIdentifier` è impostato sull'immagine. A causa di questo comportamento inaspettato, i risultati per i problemi del nome dell'ImageView nelle app UIKit verranno segnalati come Necessitano di Revisione. Un rapporto di bug è stato segnalato ad Apple. (#1633)

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

In Scroll View
Potrebbero essere segnalati problemi per il testo all'interno di elementi comportanti da 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 impostato un `accessibilityIdentifier` ma non è focalizzabile da VoiceOver e ha controlli focalizzabili nidificati al suo interno, ActiveControlName potrebbe riportare un falso positivo sull'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 aiutare a determinare lo stato della regola. In alcune gerarchie di visualizzazione, il testo vicino errato potrebbe essere rilevato causando il fallimento di queste regole. (#1622)

La nostra regola del Contrast Ratio si basa sul Machine Learning per rilevare il testo, garantendo che il testo scansionato 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 la presenza di testo, quindi la regola del Contrast Ratio non viene eseguita su questa vista.

Le app scritte in XML che utilizzano la funzione di testo suggerito potrebbero vedere falsi positivi con la EditTextName regola. Il testo suggerito non è stato introdotto fino ad Android 8 (SDK 26). Utilizzare 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 è eseguire i tuoi test su versioni più recenti di Android. Tuttavia, se è importante che l'app sia accessibile su versioni di Android precedenti, potresti considerare l'evitare l'utilizzo della hintText funzionalità, 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 complesso problema. 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 è necessario 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 test automatizzati Espresso o UIAutomator. Tuttavia, in alcuni casi, l'importazione automatica non avviene e vedrai il seguente errore nel logcat:

Axe DevTools Android: Error while running mlKit Text Detection: MlKitContext has not been initialized.

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 le dipendenze:

implementation 'com.google.mlkit:text-recognition:16.0.1'

Al momento, la regola sulla Spaziatura degli Elementi Toccabili non viene applicata a nessun componente slider scritto in Jetpack Compose. Al momento non è possibile intervenire. Tuttavia, una soluzione sta per arrivare!

Su Android API 30, una delle posizioni in cui tentiamo di salvare i risultati localmente presenta un errore di autorizzazione. Il risultato sarà 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
//    }
}

In alcune app ibride e piattaforme incrociate, 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 a schermo prima di eseguire la scansione.

Introdotta con API 31 (Android 12) è la possibilità 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 di sicurezza, ti consigliamo di lasciarla disattivata per le build di test interne dove puoi utilizzare in sicurezza i dati di test ed eliminare in tal modo 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 eventuali chiamate al metodo setHideOverlayWindows(true) in setHideOverlayWindows(false) nelle finestre delle attività interessate.

Per sbloccare tutte le funzionalità di Axe DevTools per Mobile, assicurati che gli screenshot siano abilitati. Consigliamo di abilitare gli screenshot su una versione di debug o di 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 crash con un log di errore che riporta che un adattatore non è stato trovato quando si tenta di effettuare il login alla libreria Axe DevTools. Disabilita la minimizzazione 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:

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)
    

Le API di Compose sono deprecate, ti preghiamo di utilizzare le API agnostiche al layout per continuare a ricevere aggiornamenti. Se continui a utilizzare le API di Compose e riscontri un errore del tipo `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` oppure `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, ti preghiamo di riferirti a API Compose setTestTag.

Se incontri questo messaggio, alcuni risultati delle regole potrebbero non ritornare come previsto quando quella regola utilizza l'intelligenza artificiale. Le regole interessate includono Contrasto di Colore, Testo Focusabile e Nome Elemento Annidato. (#841)

A causa delle limitazioni dell'architettura dell'app MAUI nel rendering nell'ecosistema Android, la regola Nome del Testo Modificabile verrà mostrata come Da Rivedere nella dashboard quando si sospetta un errore per la versione SDK 5.5.0 e successive. Ti preghiamo di confermare manualmente il corretto comportamento 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 verificarli manualmente per garantire che si comportino con la tecnologia assistiva come desiderato.

Se lo screenshot manca dalla pagina dei dettagli della scansione, è possibile che la tua app stia impedendo di scattare screenshot. Spesso ciò avviene per motivi di sicurezza nella tua applicazione di produzione. Considera 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 delle scansioni Android che sono di default al titolo della schermata appariranno come il nome completo della classe incluso l'identificatore del pacchetto. In un futuro aggiornamento, questo verrà risolto in modo che il titolo della schermata sia formattato in un nome più leggibile. Come soluzione temporanea, puoi impostare il nome della scansione dalla dashboard o dai framework. (#1643)