Note di rilascio di Axe DevTools Mobile 13 dicembre 2023
13 dicembre 2023
Versioni dei componenti
- axeDevToolsXCUI v2.8.2
- axe-devtools-android v5.0.0
Novità?
Android
- Ora puoi aggiungere tag alle tue scansioni dall'app Mobile Analyzer. Semplifica il tuo processo aggiungendo tag prima della scansione, invece di aggiungerli successivamente dal Mobile Dashboard.
- Per i layout di Jetpack Compose, ora riconosceremo il valore di un "onClickLabel" come descrizione del contenuto per una vista. Questo significa che le regole che richiedono una descrizione del contenuto, come Nome Vista Attiva, non falliranno in assenza di una descrizione del contenuto se è presente un onClickLabel.
- Modifica Incompatibile - Abbiamo rimosso il Pulsante di Azione Flottante (FAB) dalla libreria Android.
- Se stai utilizzando il Pulsante di Azione Flottante incorporato per i test manuali, continua a usare la versione 4.3.0 o inferiore di axe-devtools-android, oppure passa al Mobile Analyzer per testare la tua app senza incorporare alcun codice e avere accesso al set di regole più aggiornato.
- Se stai usando il Pulsante di Azione Flottante incorporato per i test automatizzati con Appium, per favore continua a usare la versione 4.3.0 o inferiore di axe-devtools-android. Rilasceremo presto un plugin per Appium, a quel punto non sarà più necessario incorporare il Pulsante di Azione Flottante nella tua app per eseguire test con Appium.
Correzioni di Bug
iOS
- Corretto un problema per cui il Mobile Analyzer si bloccava quando utilizzato con la versione 2.8.1 del framework XCUI.
- Corretto la regola Label In Name in modo che non venga eseguita su viste senza testo visibile, come pulsanti contenenti solo un'icona.
Android
- Corretta un'issue di accessibilità con un pulsante nel Mobile Analyzer che era troppo piccolo.
Dashboard
- Correzioni di accessibilità per contrasto del colore, testo sovrapposto/tagliato, un'etichetta di gruppo di checkbox mancante, pulsanti con lo stesso nome ma azioni diverse, e link con lo stesso testo ma destinazioni diverse.
- Ora puoi evidenziare e copiare il testo visualizzato all'interno della Gerarchia Visiva quando usi la funzione Ispeziona sulla pagina dei dettagli della scansione.
Problemi Noti
Se riscontri uno dei problemi elencati di seguito, contattaci all'indirizzo helpdesk@deque.com o support.deque.com. Potremo così avvisarti una volta risolto o di una soluzione alternativa identificata se non è elencata.
- Axe DevTools Mobile esegue test automatizzati su applicazioni native iOS, native Android e React Native. Contatta il tuo rappresentante Deque per soluzioni di test di accessibilità nel tuo stack tecnologico.
- Sebbene tu possa ottenere alcuni risultati da web view o PDF renderizzati, raccomandiamo vivamente di eseguire test con Axe DevTools per Web o Axe Monitor per i test di accessibilità più completi per il web.
Axe DevTools Mobile per iOS
Errore nel Progetto Analyzer e Test per ID Pacchetto nella versione 2.8.1
La funzionalità per testare un'applicazione tramite identificatore di pacchetto è stata interrotta nella versione 2.8.1, causando un errore intitolato "Nessun percorso dell'applicazione di destinazione specificato tramite configurazione del test: ...". Aggiorna alla versione 2.8.2 o all'ultima versione per risolvere l'errore. Aggiorna all'ultima versione nel progetto iOS Analyzer.
Le viste fuori schermo possono mostrare risultati per app SwiftUI testate in iOS 17
Con la versione 2.8.0 (Visualizza Note di Rilascio), i risultati non vengono più riportati su viste non visibili, inclusi quelle fuori schermo o nascoste da un'altra vista. Abbiamo scoperto che nelle applicazioni SwiftUI testate in iOS 17, alcuni risultati continuano a essere mostrati. (#1383)
Regola Supporta Tipo Dinamico non funzionante con simulatore iOS 15 Pro
C'è un problema che riguarda il simulatore iPhone 15 Pro che impedisce l'esecuzione della regola Supporta Tipo Dinamico. Se sei iscritto alla regola Supporta Tipo Dinamico, non sarai in grado di testarla utilizzando un simulatore iPhone 15 Pro. È stato segnalato un bug ad Apple.
Regole contro Controlli Annidati
Mentre valutavamo un miglioramento per le nostre regole, abbiamo scoperto che in XCTest, i controlli annidati non vengono restituiti nell'albero di accessibilità. È stato segnalato un bug ad Apple. (#1110)
Falso Positivo: In Scroll View, Nome Controllo Attivo
Stiamo lavorando attivamente a correzioni per i seguenti falsi positivi e aggiorneremo questo elenco man mano che le correzioni verranno rilasciate.
In Scroll View
Può segnalare problemi per il testo all'interno di elementi simili a banner. Per rendere questi elementi disponibili a coloro che richiedono testo più grande, utilizza UILargeContentViewer. (#622)
ActiveControlName
Se un UIImageView ha impostato un `accessibilityIdentifier` ma non è focalizzabile tramite VoiceOver, e ha controlli focalizzabili annidati all'interno, NomeControlloAttivo può segnalare un falso positivo su UIImageView. Rimuovere il `accessibilityIdentifier` risolve il problema. È stato segnalato un bug ad Apple. (#1226)
Falso Negativo: Nome Immagine Vista, Testo Focalizzabile in iOS 13 fino a iOS 14.8.1
Stiamo lavorando attivamente a correzioni per i seguenti falsi negativi e aggiorneremo questo elenco man mano che le correzioni verranno rilasciate.
Image View Name
Se un UIImageView ha impostato un `accessibilityIdentifier` ma non è focalizzabile tramite VoiceOver, NomeImmagineVista può segnalare un falso negativo su UIImageView. Rimuovere il `accessibilityIdentifier` risolve il problema. È stato segnalato un bug ad Apple. (#1226)
Focusable Text
Gli elementi contrassegnati come non accessibili possono riportare risultati non corretti a causa di un bug nel framework di Apple.
Axe DevTools Mobile per Android
Crash quando si utilizza Proguard
Se la tua build di debug o test utilizza Proguard, segui i passaggi per ignorare Deque nelle impostazioni di Proguard.
Crash quando `minifiedEnabled` è impostato su true
Se riduci al minimo la tua build, vedrai 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. Disabilita la riduzione al minimo per le build di debug con Axe DevTools implementato. (#729)
Errori di compilazione con il progetto Java8 e Axe DevTools Android 3.1.0
Prova i seguenti import:
implementation 'androidx.core:core-ktx:1.9.0' implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.4' implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.4'After importing the above library, if you see errors related to minSDK version for core-ktx library try the following in your project’s Android Manifest:
<uses-sdk tools:overrideLibrary="androidx.core" />
Le build con r8 abilitato generano un errore
Una build con r8 abilitato potrebbe tentare di ridurre al minimo 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)To resolve this error add the following line to your ProGuard file to keep axeDevTools classes:
keep class com.deque.** { *; }
Messaggio di errore simile a:
Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)
Se incontri un errore del tipo `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)`, contattaci all'indirizzo helpdesk@deque.com o support.deque.com per assistenza. In determinate condizioni, potrebbero esistere due nodi radice di Compose allo stesso tempo.
Dashboard Mobile di Axe DevTools
Screenshot mancante
Se lo screenshot manca dalla pagina dei dettagli della scansione, la tua app potrebbe impedire la cattura degli screenshot. Spesso ciò avviene per motivi di sicurezza nella tua applicazione di produzione. Considera l'idea di rimuovere questo requisito per la tua build di testing per permettere la piena funzionalità nel Dashboard Mobile di Axe DevTools.
Alcuni nomi di scansioni Android non sono formattati
Alcuni nomi delle scansioni Android che vengono preimpostati sul titolo dello schermo appariranno come nome completo della classe incluso l'identificatore del pacchetto. In una versione futura, questo sarà risolto affinché 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)