Problemi Conosciuti

La regola del Contrasto del Colore utilizza il framework Vision di Apple (Optical Character Recognition, o OCR) per leggere il testo all'interno dei confini di un elemento. L'OCR può occasionalmente identificare erroneamente piccoli glifi simili a icone - come frecce a forma di < per ritornare indietro, punti elenco, simboli decorativi - come testo. Quando ciò accade, la regola del Contrasto del Colore si applica a un elemento che non contiene testo leggibile, il che può produrre un risultato per un pulsante solo icona. Poiché l'output dell'OCR non è deterministico attraverso le scansioni, lo stesso elemento può apparire nei risultati del Contrasto del Colore in una scansione e essere segnalato come "NON APPLICABILE" nella successiva. Questa è una caratteristica nota dell'OCR, non un bug nella regola.

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

// Ignore Color Contrast for a specific element by accessibility identifier
axeDevTools?.configuration.ignore(rulesFor: [
    "backButton": [AxeRuleId.ColorContrast.toString()]
])

Flutter non mappa AppBar.title alla proprietà nativa del titolo della schermata - UIViewController.title, causando il fallimento della regola Titolo Schermata in tutte le schermate Flutter, indipendentemente dalla presenza di un titolo descrittivo.

Questa è una limitazione nota della piattaforma Flutter monitorata in flutter/flutter#185894.

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

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

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 dell'interfaccia utente nativa). Ciò accade perché il sistema di accessibilità verifica se il contenitore WKWebView stesso è visibile, piuttosto che controllare se il contenuto web è effettivamente non ostruito e percepibile dall'utente.

iOS 26 contiene un bug di accessibilità in cui i pulsanti stepper predefiniti non annunciano "attutito" dalla Tecnologia Assistiva per indicare che non sono abilitati. Di conseguenza, anche le regole di iOS considerano questi pulsanti come abilitati anche se non lo sono. È stata presentata una segnalazione di bug ad Apple, ma fino a quando non sarà 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à [ignorare le regole](ios-ignore-rule). I pulsanti stepper predefiniti hanno gli identificatori "Decrementa" e "Incrementa", e possono essere ignorati tramite 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.

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

C'è un problema che interessa il simulatore iPhone 15 Pro che impedisce l'esecuzione della regola Supports Dynamic Type. Se hai scelto di aderire alla regola Supports Dynamic Type, non sarai in grado di testarla utilizzando un simulatore iPhone 15 Pro. È stato presentato un bug ad Apple.

Durante il miglioramento delle nostre regole, abbiamo scoperto che in XCTest, i controlli annidati 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 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 inatteso, i risultati per i problemi del Nome ImageView nelle app UIKit verranno segnalati come Bisogno di Revisione. È stata presentata una segnalazione di bug ad Apple. (#1633)

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

In Scroll View
Il testo all'interno di elementi comportanti banner può essere contrassegnato con un messaggio "Necessita revisione". Per rendere questi elementi disponibili a chi richiede un testo più grande, utilizzare UILargeContentViewer. (#622)

v2.11.0 Image View Name & Active Control Name
Se una UIImageView ha un `accessibilityIdentifier` impostato ma non è focalizzabile tramite VoiceOver, e ha controlli focalizzabili annidati al suo interno, ActiveControlName può segnalare un falso positivo sulla UIImageView. Rimuovere il `accessibilityIdentifier` risolve il problema. È stato registrato un bug con 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, potrebbe essere rilevato del testo errato nelle vicinanze causando il fallimento di queste regole. (#1622)

Quando si usa testo decorativo in viste come "Icone di contatto", è possibile introdurre un problema di accessibilità. Se usi una vista di testo per visualizzare lettere invece di generare immagini con le lettere desiderate come vettori, e dichiari poi che quella vista di testo non è importante per l'accessibilità, non saremo in grado di determinare in modo affidabile se hai introdotto una violazione dell'accessibilità.

Se modifichi il testo focalizzabile per ignorare due o meno caratteri, potresti involontariamente ignorare molti pulsanti di una parola in varie lingue (ad esempio "OK", "No", "Sí"). Per evitare questi problemi, dovresti prendere le lettere desiderate dalla parola che vuoi rappresentare nell'icona e generare le lettere come parte dell'immagine anziché come viste di testo separate. `FocusableText` quindi non verrà eseguito su quelle viste.

Flutter non mappa AppBar.title alla proprietà nativa del titolo dello schermo - Activity.setTitle, causando il fallimento della regola del titolo dello schermo su tutti gli schermi Flutter indipendentemente dalla presenza di un titolo descrittivo.

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

In alcuni casi, la tecnologia assistiva si affida a AccessibilityEvent descrizioni dal sistema Android per annunciare informazioni all'utente quando non ci sono altri annunci disponibili. Poiché AccessibilityEventvengono attivati da azioni dell'utente, non siamo in grado di accedere alla descrizione corretta se queste informazioni non sono fornite.

Per evitare questo problema, assicurati che tutte le viste pertinenti siano contrassegnate come importanti per l'accessibilità. Questo permetterà a Talkback di accedere alle informazioni dalla vista, che il nostro strumento potrà quindi rilevare.

La nostra regola del contrasto dei colori dipende dal Machine Learning per rilevare il testo, il che garantisce che il testo analizzato 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 Machine Learning non è in grado di rilevare se il testo è presente, quindi la regola del contrasto dei colori non viene eseguita su questa vista.

Le app scritte con 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). Usare 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, tuttavia, potresti considerare di evitare l'uso della hintText funzione, poiché non è ufficialmente supportata.

Potresti vedere risultati per visualizzazioni che sono nascoste dietro altre visualizzazioni sullo schermo. Queste visualizzazioni nascoste non sono disponibili per la tecnologia assistiva, ma axe DevTools Mobile le riporta comunque come problemi.

Stiamo lavorando a una soluzione per questo problema complesso. Nel frattempo, se TalkBack non riesce a raggiungere queste visualizzazioni, puoi ignorare i relativi problemi. Non richiedono una soluzione 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 test automatizzati Espresso o UIAutomator. In alcuni casi, tuttavia, 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 risolvere 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 di tocco attualmente non viene eseguita su alcun componente slider scritto in Jetpack Compose. Al momento non è possibile intraprendere alcuna azione. 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'

In alcune app ibride e cross-platform, potremmo restituire risultati inaspettati quando gli elementi in una vista a scorrimento sono parzialmente fuori dallo schermo. Per testare un elemento per l'accessibilità, assicurati che sia completamente visibile sullo 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 della sicurezza, ti consigliamo di lasciarla disattivata per le versioni di test interne dove puoi utilizzare in sicurezza i dati di prova ed eliminare in questo 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 tutte le chiamate 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 di test della tua app che utilizza dati fittizi per evitare preoccupazioni di sicurezza. Consulta la nostra guida per abilitare gli screenshot nelle app Android.

Se si minimizza la build, si verificherà un crash con un log di errore che segnala che non è stato possibile trovare un adattatore quando si tenta di accedere alla libreria axe DevTools. Disabilitare la minimizzazione per le 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 Compose sono deprecate, si prega di usare le API indipendenti dal layout per continuare a ricevere aggiornamenti. Se si continua a usare le API 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 fare riferimento a Compose setTestTag API.

A causa delle limitazioni dell'architettura dell'app MAUI nel sistema Android, la regola Nome Edit Text verrà mostrata come Necessita Revisione 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 si implementano dialoghi o modali personalizzati che non estendono i controlli nativi, è possibile ottenere risultati per le visualizzazioni dietro il modale. In questo caso, consigliamo di non eseguire il nostro strumento contro questi modali o dialoghi personalizzati e invece verificarli manualmente per assicurarci che funzionino con la tecnologia assistiva come desiderato.

Se lo screenshot manca dalla pagina dei dettagli della scansione, la tua app potrebbe prevenire la cattura degli screenshot. Spesso ciò avviene per motivi di sicurezza nella tua applicazione di produzione. Considera di rimuovere questo requisito per la tua build di testing per consentire la piena funzionalità nel Dashboard Mobile 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 una versione futura, 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 dashboard o dai framework. (#1643)