Note di rilascio di Axe DevTools Mobile 8 aprile 2026

Quando esegui controlli di accessibilità su schermi di piccole dimensioni o con dimensioni di carattere ridotte, la regola di contrasto cromatico può segnalare falsi positivi per sfondi sfumati. In tali casi, potrebbe non essere in grado di determinare il colore di primo piano e quindi confrontare i colori di sfondo tra loro, risultando in un errore.

Per ovviare a 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 cromatico per queste visualizzazioni.

Le API di accessibilità di Apple possono riportare in modo errato il contenuto web all'interno di WKWebView come "isVisible", anche quando la web view è coperta da sovrapposizioni native (come modali, avvisi o altri elementi UI native). Questo accade perché il sistema di accessibilità controlla 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" dalla Tecnologia Assistiva per indicare che non sono abilitati. Di conseguenza, le regole iOS vedono anche questi pulsanti come abilitati anche se non lo sono. È stato segnalato un bug ad Apple, ma fino a quando non verrà risolto, le seguenti regole potrebbero 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.

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

C'è un problema che riguarda il simulatore iPhone 15 Pro che impedisce l'esecuzione della regola Supports Dynamic Type. Se hai aderito alla regola Supports Dynamic Type, non sarai in grado di testarla usando un simulatore iPhone 15 Pro. Un bug è stato segnalato ad Apple.

Durante la revisione per migliorare le nostre regole, abbiamo scoperto che in XCTest i controlli nidificati non vengono restituiti nell'albero dell'accessibilità. Un bug è stato segnalato ad Apple. (#1110)

Nelle app UIKit, un'immagine senza un `accessibilityLabel` non è focalizzabile con le tecnologie assistive di default.
Le proprietà che usiamo per verificare la focalizzabilità da Apple possono essere inaccurate quando un `accessibilityIdentifier` è impostato sull'immagine. A causa di questo comportamento inatteso, i risultati per i problemi di ImageView Name nelle app UIKit verranno segnalati come da rivedere. È stata segnalata una segnalazione di bug ad Apple. (#1633)

Stiamo lavorando attivamente a correzioni per i seguenti falsi positivi e aggiorneremo questa lista non appena le correzioni verranno rilasciate.

In Scroll View
Il testo all'interno di elementi che si comportano come banner può essere contrassegnato con un messaggio "Da rivedere". 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 una UIImageView ha un `accessibilityIdentifier` impostato ma non è focalizzabile da VoiceOver, e ha controlli focalizzabili nidificati al suo interno, ActiveControlName può segnalare un falso positivo sulla UIImageView. Rimuovere l'`accessibilityIdentifier` risolve il problema. È stata segnalata una segnalazione 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 determinare lo stato della regola. In alcune gerarchie di vista, può essere rilevato un testo vicino incorretto causando il fallimento di queste regole. (#1622)

In alcuni casi, le tecnologie assistive si affidano a AccessibilityEvent descrizioni dal sistema Android per annunciare informazioni all'utente quando non è disponibile nessun altro annuncio. Poiché AccessibilityEvents are triggered by user actions, we are unable to access the correct description if this information is not provided.

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 del contrasto del colore si basa sull'apprendimento automatico 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 è dello stesso colore dello sfondo, il nostro algoritmo di apprendimento automatico non è in grado di rilevare se è presente del testo, quindi la regola del contrasto del colore non viene eseguita su questa vista.

Le app scritte con XML che utilizzano la funzione hint text possono vedere 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 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. Tuttavia, se è importante che l'app sia accessibile su versioni precedenti di Android, potresti considerare di evitare l'uso della hintText funzione, poiché non è supportata ufficialmente.

Potresti vedere risultati per le viste che sono nascoste da altre viste sullo schermo. Queste viste nascoste non sono disponibili per le tecnologie assistive, ma Axe DevTools Mobile le segnala 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 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 importata automaticamente quando si fa riferimento a Axe DevTools Mobile nei tuoi test automatizzati Espresso o UIAutomator. In alcuni casi, tuttavia, non avviene l'importazione automatica 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 file della tua applicazione build.gradle , aggiungi quanto segue sotto le dipendenze:

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

La regola della Spaziatura del Target Tocco attualmente non viene eseguita su alcun componente slider che è stato scritto in Jetpack Compose. Non è possibile 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'

In alcune app ibride e multipiattaforma, potremmo restituire risultati inattesi quando gli elementi in una vista scorrevole sono parzialmente fuori schermo. Per testare l'accessibilità di un elemento, assicurati che sia completamente sullo schermo prima di effettuare la scansione.

Introdotta con l'API 31 (Android 12) è la capacità di nascondere sovrapposizioni non di sistema. Per poter 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 interne dove puoi utilizzare tranquillamente i dati di test ed eliminare in questo modo le preoccupazioni relative alla 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 le eventuali chiamate al metodo setHideOverlayWindows(true) a setHideOverlayWindows(false) nelle finestre dell'attività interessate.

Per sbloccare la piena funzionalità di Axe DevTools per dispositivi mobili, 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 fittizi per evitare problemi di sicurezza. Consulta la nostra guida per abilitare gli screenshot nelle app Android.

Se si minimizza la build, verrà visualizzato un crash con un registro degli errori che segnala che un adattatore non è stato trovato durante il tentativo di accedere alla libreria Axe DevTools. Disabilitare la minimizzazione per le build di debug con Axe DevTools implementato. (#729)

Una build con r8 abilitato potrebbe 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 Compose sono deprecate, si prega di utilizzare le API agnostiche al 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()?`, si prega di fare riferimento alle API Compose setTestTag.

A causa delle limitazioni dell'architettura dell'app MAUI nel rendering nell'ecosistema Android, la regola Nome Modifica Testo verrà mostrata come Richiede Revisione nel pannello di controllo 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, è possibile ottenere risultati per le viste dietro il modale. In questo caso, si consiglia di non eseguire il nostro strumento contro questi modali o dialoghi personalizzati e invece verificarli manualmente per garantire che si comportino con la tecnologia assistiva come desiderato.

Se lo screenshot manca dalla pagina dei dettagli della scansione, l'app potrebbe impedire che vengano scattati 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à nel Dashboard Mobile di Axe DevTools.

• Android - FLAG_SECURE

Alcuni nomi di scansione Android che sono predefiniti al titolo dello schermo appariranno come il nome completo della classe inclusivo dell'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, puoi impostare il nome della scansione dal pannello di controllo o dai framework. (#1643)