Note di Rilascio di Axe DevTools Mobile 12 Febbraio 2025

La funzionalità di test di un'applicazione tramite identificatore del pacchetto era interrotta nella versione 2.8.1, il che ha causato un errore intitolato "Nessun percorso applicazione target specificato tramite configurazione del test: ...". Aggiorna alla versione 2.8.2 o all'ultima versione per risolvere l'errore. Aggiorna all'ultima versione all'interno del progetto iOS Analyzer.

La scansione di alcune applicazioni con questa versione dell'analizzatore e SDK comportava un errore "Impossibile serializzare l'errore AxeResult". Aggiorna all'ultima versione per risolvere l'errore. Aggiorna all'ultimo progetto iOS Analyzer.Aggiorna all'ultimo SDK iOS.

Alcune schermate 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 Supporta Tipo Dinamico. Se hai aderito alla regola Supporta Tipo Dinamico, non potrai testarla utilizzando un simulatore iPhone 15 Pro. È stato presentato un bug ad Apple.

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

Nelle app UIKit, un'immagine senza un `accessibilityLabel` non è focalizzabile con tecnologia assistiva di default.
Le proprietà che utilizziamo per verificare la focalizzabilità da Apple potrebbero essere imprecise quando un `accessibilityIdentifier` è impostato sull'immagine. A causa di questo comportamento inatteso, i risultati per i problemi di Nome ImageView nelle app UIKit saranno segnalati come Bisogno di Revisione. È stato presentato un rapporto di bug ad Apple. (#1633)

Stiamo lavorando attivamente per risolvere i seguenti falsi positivi e aggiorneremo questo elenco non appena verranno rilasciate le correzioni.

In Scroll View
Potrebbero esserci segnalazioni di problemi per il testo all'interno di elementi con comportamento da banner. Per rendere questi elementi accessibili a chi necessita di testo più grande, utilizzare 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 sull'UIImageView. Rimuovere l'`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 gli elementi vicini per determinare lo stato della regola. In alcune gerarchie di vista, potrebbe essere rilevato il testo vicino errato, causando il fallimento di queste regole. (#1622)

La regola Spaziatura del bersaglio tocco attualmente non viene eseguita su nessun componente slider scritto in Jetpack Compose. Al momento, non si possono prendere provvedimenti. Tuttavia, una correzione è in arrivo!

Su Android API 30, uno dei luoghi in cui tentiamo di salvare i risultati localmente ha un errore di permesso. 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 multipiattaforma, potremmo ottenere risultati inattesi quando gli elementi in una vista a scorrimento sono parzialmente fuori 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 funzione per i suoi miglioramenti di sicurezza, ti consigliamo di mantenerla spenta per le build di test interne dove puoi utilizzare in sicurezza i dati di test ed 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 le chiamate al metodo setHideOverlayWindows(true) a setHideOverlayWindows(false) sulle finestre di 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 preoccupazioni di sicurezza. Consulta la nostra guida per abilitare gli screenshot nelle app Android.

Se riduci il tuo build, vedrai un crash con un registro degli errori che riporta che non è stato possibile trovare un adattatore quando si tenta di effettuare il login alla libreria Axe DevTools. Disabilita la minimizzazione per i tuoi 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)
    

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

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

A causa delle limitazioni dell'architettura dell'app MAUI nel rendering nell'ecosistema Android, la regola Nome Testo Modificabile verrà mostrata come Necessita Revisione nel dashboard quando si sospetta un fallimento per la versione SDK 5.5.0 e successive. Si prega di confermare manualmente il comportamento corretto in 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 assicurarti che si comportino come desiderato con la tecnologia assistiva.

Se lo screenshot manca dalla pagina dei dettagli della scansione, la tua 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 il tuo 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 dello schermo appariranno come il nome completo della classe incluso l'identificatore di 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)