axe DevTools Mobile Note sulla versione del 13 dicembre 2023
13 Dicembre, 2023
Versioni dei componenti
- axeDevToolsXCUI v2.8.2
- axe-devtools-android v5.0.0
Cosa c'è di nuovo?
Android
- Ora puoi aggiungere tag alle tue scansioni dall'app Mobile Analyzer. Semplifica il tuo processo aggiungendo i tag prima di eseguire la scansione, anziché aggiungerli in un secondo momento dalla dashboard del mobile.
- Per i layout di Jetpack Compose, ora riconosceremo il valore di "onClickLabel" come descrizione del contenuto per una vista. Ciò significa che le regole che richiedono una descrizione del contenuto, come Active View Name, non falliranno in assenza di una descrizione del contenuto se è presente un'etichetta onClickLabel.
- Modifica importante: abbiamo rimosso il Floating Action Button (FAB) dalla libreria Android.
- Se utilizzi il Floating Action Button incorporato per i test manuali, continua a utilizzare axe-devtools-android versione 4.3.0 o precedente oppure passa a Mobile Analyzer per testare la tua app senza incorporare alcun codice e avere accesso al ruleset più aggiornato.
- Se si utilizza il Floating Action Button incorporato per i test automatizzati con Appium, continuare a utilizzare axe-devtools-android versione 4.3.0 o precedente. Presto pubblicheremo un plugin Appium, a partire dal quale non sarà più necessario incorporare il Floating Action Button nella tua app per eseguire test con Appium.
Correzioni di bug
iOS
- Risolto un problema per cui Mobile Analyzer si bloccava quando veniva utilizzato con la versione 2.8.1 del framework XCUI.
- Corretta la regola Etichetta nel nome, in modo che non venga più eseguita nelle viste senza testo visibile, come i pulsanti che contengono solo un'icona.
Android
- Risolto un problema di accessibilità con un pulsante troppo piccolo nel Mobile Analyzer.
Pannello di controllo
- Correzioni di accessibilità per contrasto di colore, testo sovrapposto/tagliato, etichetta di gruppo di caselle di controllo mancante, pulsanti con lo stesso nome ma azioni diverse e link con lo stesso testo ma destinazioni diverse.
- Ora è possibile evidenziare e copiare il testo visualizzato nella gerarchia di visualizzazione quando si utilizza la funzione Ispeziona nella 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. Saremo quindi in grado di informarti una volta risolto il problema o di una soluzione alternativa individuata, se non ne è elencata nessuna.
- I test automatizzati di axe DevTools Mobile vengono eseguiti su applicazioni native iOS, native Android e React Native. Contatta il tuo rappresentante Deque per soluzioni di test di accessibilità sul tuo stack tecnologico.
- Anche se potresti ottenere alcuni risultati dalle visualizzazioni web o dai PDF renderizzati, ti consigliamo vivamente di effettuare dei test utilizzando axe DevTools for Web o axe Monitor per i test di accessibilità per il web più completi.
axe DevTools Mobile per iOS
Errore nel progetto Analyzer e Test tramite ID del bundle in 2.8.1
Nella versione 2.8.1, la funzionalità di test di un'applicazione tramite identificatore bundle non funzionava, provocando un errore denominato "Nessun percorso dell'applicazione di destinazione specificato tramite la configurazione del test: ...". Per risolvere l'errore, esegui l'aggiornamento alla versione 2.8.2 o all'ultima versione. Aggiorna alla versione più recente del progetto iOS Analyzer.
Le Viste fuori dallo schermo potrebbero mostrare risultati per le app SwiftUI testate in iOS 17
Con la versione 2.8.0 (Visualizza note di rilascio), i risultati non vengono più segnalati nelle viste non visibili, comprese quelle fuori dallo schermo o nascoste da un'altra vista. Abbiamo scoperto che nelle applicazioni SwiftUI testate in iOS 17 alcuni risultati sono ancora visibili. (#1383)
La regola Supporta il tipo dinamico non funziona con il simulatore iOS 15 Pro
Si è verificato un problema nel simulatore dell'iPhone Pro con iOS 15 che impedisce l'esecuzione della regola Supporta i tipi dinamici. Se hai scelto la regola Supporta il tipo dinamico, non potrai testarlo utilizzando un simulatore di iPhone Pro con iOS 15. È stato segnalato un bug ad Apple.
Regole contro i controlli nidificati
Esaminando un possibile miglioramento delle nostre regole, abbiamo scoperto che in XCTest i controlli nidificati non vengono restituiti nell'albero di accessibilità. È stato segnalato un bug ad Apple. (#1110)
Falso positivo: in Scroll View, ActiveControlName
Stiamo lavorando attivamente per risolvere i seguenti falsi positivi e aggiorneremo questo elenco non appena saranno pubblicate le correzioni.
Nella vista a scorrimento
Potrebbero essere segnalati problemi relativi al testo all'interno di elementi che si comportano come banner. Per rendere questi elementi disponibili a coloro che necessitano di testo più grande, utilizzare UILargeContentViewer. (#622)
NomeControlloAttivo
Se un UIImageView ha un `accessibilityIdentifier` impostato ma non è attivabile da VoiceOver, e al suo interno contiene controlli attivabili, ActiveControlName potrebbe segnalare un falso positivo su UIImageView. Rimuovendo il `accessibilityIdentifier` il problema viene risolto. È stato segnalato un bug ad Apple. (#1226)
Falso negativo: nome della visualizzazione dell'immagine, testo selezionabile in iOS 13 tramite iOS 14.8.1
Stiamo lavorando attivamente per correggere i seguenti falsi negativi e aggiorneremo questo elenco non appena saranno pubblicate le correzioni.
Nome ImageView
Se un UIImageView ha un `accessibilityIdentifier` impostato ma non è attivabile tramite VoiceOver, NomeImageView potrebbe segnalare un falso negativo su UIImageView. Rimuovendo il `accessibilityIdentifier` il problema viene risolto. È stato segnalato un bug ad Apple. (#1226)
Testo selezionabile
Gli elementi contrassegnati come elementi non accessibili potrebbero segnalare risultati errati a causa di un bug nel framework di Apple.
axe DevTools Mobile per Android
Arresto anomalo durante l'utilizzo di Proguard
Se la build di debug o di test utilizza Proguard, seguire i passaggi per escludere Deque nelle impostazioni di Proguard.
Arresto anomalo quando `minifiedEnabled` è impostato su true
Se minimizzi la tua compilazione, vedrai un crash con un registro degli errori che segnala che non è stato possibile trovare un adattatore quando provi ad accedere alla libreria axe DevTools. Disabilita la minimizzazione per le compilazioni di debug con axe DevTools implementato. (#729)
Errori di compilazione con Java8 Project e axe DevTools Android 3.1.0
Prova le seguenti importazioni:
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'Dopo aver importato la libreria sopra, se vedi errori relativi alla versione minSDK per la libreria core-ktx, prova quanto segue nel manifesto Android del tuo progetto:
<uses-sdk tools:overrideLibrary="androidx.core" />
Le build con r8 abilitato generano un errore
Una compilazione con r8 abilitato potrebbe tentare di minimizzare la libreria axeDevTools, generando 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)Per risolvere questo errore, aggiungi la seguente riga al tuo file ProGuard per mantenere le classi axeDevTools:
keep class com.deque.** { *; }
Messaggio di errore simile a:
Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)
Se riscontri un errore del tipo `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)`, contattaci a helpdesk@deque.com o support.deque.com per assistenza. In determinate condizioni, potrebbero esistere contemporaneamente due nodi radice Compose.
Dashboard di axe DevTools Mobile
Screenshot mancante
Se lo screenshot non è presente nella pagina dei dettagli della scansione, è possibile che l'app impedisca l'acquisizione degli screenshot. Spesso ciò avviene per motivi di sicurezza nell'applicazione di produzione. Considera di rimuovere questo requisito dalla build di test per consentire la piena funzionalità nella dashboard mobile di axe DevTools.
Alcuni nomi di scansione Android non sono formattati
Alcuni nomi di scansione Android che per impostazione predefinita compaiono nel titolo della schermata appariranno come nome completo della classe, incluso l'identificativo del bundle. In una versione futura, questo verrà risolto in modo che il titolo dello schermo sia formattato in un nome più leggibile. Come soluzione alternativa, puoi impostare il nome della scansione dalla dashboard o dai framework. (#1643)