Note di rilascio di Axe DevTools Mobile del 17 aprile 2024
17 aprile 2024
Versioni dei componenti
- iOS SDK & Analyzer (axeDevToolsXCUI v2.10.0)
- Android SDK (axe-devtools-android v5.4.0)
- Analizzatore Android (Axe Accessibility Analyzer v1.7.0)
Modalità di aggiornamento: iOS SDK, Analizzatore iOS, SDK Android, Analizzatore Android
Novità?
Tracciamento dell'utilizzo
Abbiamo reso più facile abilitare il tracciamento per l'utilizzo del tuo team di Axe DevTools Mobile. Nelle impostazioni globali del Portale di Axe Account, imposta "Servizio di Utilizzo" su "Abilitato" e inserisci il tuo URL e l'ID dell'Organizzazione. Non è più necessario aggiungere nulla al codice. (Nota: il tracciamento dell'utilizzo già configurato tramite codice per i tuoi test automatizzati continuerà a funzionare.) Contatta helpdesk@deque.com per il tuo ID dell'Organizzazione. Come abilitare il Servizio di Utilizzo | Informazioni sul Servizio di Utilizzo
Esportazione scansioni nel Formato Universale Axe
Ora puoi esportare le scansioni dalla Dashboard di Axe DevTools Mobile nel formato JSON universale Axe, uno standard utilizzato da tutti i prodotti Axe. Usa questo formato quando desideri importare i risultati di accessibilità mobile in un altro prodotto Deque, come Axe Auditor, o quando vuoi aggregare programmaticamente i risultati di accessibilità da più prodotti Axe usando un output coerente da ciascun prodotto. Come esportare le scansioni dalla Dashboard | Formato mobile rispetto a formato universale
Android
- Abbiamo promosso le regole Vista Accessibile Inattiva e Testo Focalizzabile fuori dallo stato sperimentale. Dopo una rigorosa valutazione, siamo fiduciosi nei loro risultati. Se hai disabilitato le regole sperimentali dalle impostazioni della Dashboard, inizierai a vedere i risultati di queste regole. In caso contrario, continuerai a ottenere risultati da queste regole, ma non appariranno più nella sezione "Risultati Sperimentali". Informazioni sulle regole sperimentali | Configurazione della Dashboard
iOS
- Stiamo deprecando la regola Controlli in Collisione. I controlli in collisione ora sono coperti dalla regola allineata a WCAG, Spaziatura Obiettivo Tocco. I risultati per i Controlli in Collisione ora appariranno in "Ignorati". Rimuoveremo completamente i risultati in un prossimo rilascio.
Correzione di bug
Android
- Abbiamo aggiornato l'app Mobile Analyzer per evitare crash durante l'avvio su Android versione 11 e inferiori.
- Abbiamo risolto un problema nell'app Mobile Analyzer dove un URL errato del server backend causava il fallimento della configurazione dell'app. Questo si applica solo ai clienti su cloud privato o on-premise.
- Abbiamo risolto un bug nella regola Etichetta nel Nome che stava causando un errore nel ritorno della regola quando il testo visibile faceva parte del nome accessibile.
- Per prevenire falsi positivi, qualsiasi componente il cui contenuto non è completamente sullo schermo non sarà più analizzato dalle regole Dimensione Obiettivo Tocco, Spaziatura Obiettivo Tocco o Contrasto Cromatico.
- Per prevenire falsi positivi nelle regole Etichetta nel Nome, Nome Elemento Nidificato e Testo Focalizzabile, ora segnaleremo certi scenari come "Da Rivedere" piuttosto che "Fallito" quando non possiamo essere al 100% certi di un fallimento. Dovresti rivedere questi problemi per garantire che il testo accessibile sia disponibile alla tecnologia assistiva come TalkBack o Accesso Vocale.
iOS
- Per prevenire falsi positivi, la regola Viste in Collisione restituirà "Da Rivedere" invece di "Fallito" in tutti i casi.
- Il Servizio di Utilizzo precedentemente tracciava solo eventi "login" e ora traccerà sia eventi "login" che "scan".
Dashboard
- Risolto un bug per cui le scansioni non potevano essere esportate quando il nome dell'app conteneva un carattere Unicode.
Problemi noti
Se riscontri uno dei seguenti problemi, contattaci a helpdesk@deque.com o support.deque.com. Potremo così notificarti una volta risolto o informarci di una soluzione alternativa identificata se non è elencata.
- Axe DevTools Mobile esegue test automatici su applicazioni native iOS, Android native e React Native. Contatta il tuo rappresentante Deque per soluzioni di test di accessibilità per il tuo stack tecnologico.
- Sebbene tu possa ottenere alcuni risultati dai web view o dai PDF resi, ti consigliamo vivamente di effettuare i test utilizzando Axe DevTools per il Web o Axe Monitor per il test di accessibilità più completo per il web.
Axe DevTools Mobile per iOS
Errore nel progetto Analyzer e test tramite ID bundle in 2.8.1
La funzionalità di test di un'applicazione tramite identificatore di bundle è stata interrotta nella versione 2.8.1, il che ha generato un errore con il messaggio "Nessun percorso applicazione target specificato tramite configurazione del test: ...". Aggiorna alla versione 2.8.2 o a quella più recente per risolvere l'errore. Aggiorna all'ultima versione all'interno del progetto iOS Analyzer.
Le viste fuori schermo possono 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ù riportati per le viste non visibili, incluse quelle fuori schermo o nascoste da un'altra vista. Abbiamo scoperto che nelle applicazioni SwiftUI testate in iOS 17, alcuni risultati vengono ancora mostrati. (#1383)
La regola Supporta Tipo Dinamico non funziona con il simulatore iOS 15 Pro
C'è un problema che influisce sul simulatore iPhone 15 Pro che impedisce l'esecuzione della regola Supporta Tipo Dinamico. Se hai attivato la regola Supporta Tipo Dinamico, non potrai testarla utilizzando un simulatore iPhone 15 Pro. È stato segnalato un bug ad Apple.
Regole contro controlli nidificati
Durante l'esame di un 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: ActiveControlName in Scroll View
Stiamo lavorando attivamente su correzioni per i seguenti falsi positivi e aggiorneremo questo elenco man mano che le correzioni verranno rilasciate.
In Scroll View
Potrebbe segnalare problemi per il testo all'interno di elementi con comportamento di banner. Per rendere disponibili questi elementi a chi necessita di testo più grande, utilizza UILargeContentViewer. (#622)
ActiveControlName
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. (#1226)
Falso negativo: Nome vista immagine, Testo focalizzabile in iOS 13 fino a iOS 14.8.1
Stiamo lavorando attivamente su correzioni per i seguenti falsi negativi e aggiorneremo questo elenco man mano che le correzioni verranno rilasciate.
Image View Name
Se un UIImageView ha un `accessibilityIdentifier` impostato ma non è focalizzabile da VoiceOver, ImageViewName potrebbe segnalare un falso negativo sull'UIImageView. Rimuovere l'`accessibilityIdentifier` risolve il problema. È stato segnalato un bug ad Apple. (#1226)
Focusable Text
Gli elementi contrassegnati come non elementi di accessibilità potrebbero segnalare risultati impropri a causa di un errore nel framework di Apple.
Axe DevTools Mobile per Android
Arresto anomalo quando si utilizza Proguard
Se la tua build di debug o test utilizza Proguard, segui i passaggi per ignorare Deque nelle impostazioni di Proguard.
Arresto anomalo quando `minifiedEnabled` è impostato su true
Se stai minimizzando la tua build, vedrai un errore di arresto anomalo che riporta che un adattatore non è stato trovato quando si tenta di accedere alla libreria Axe DevTools. Disabilita la minimizzazione per le build di debug con Axe DevTools implementato. (#729)
Le build con r8 abilitato generano un errore
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)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)
oppure: No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?
Se incontri un errore simile a `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` o `Nessuna vista inizializzata, hai chiamato AxeDevToolsCompose.setComposeTestRule()?`, fai riferimento a API Compose setTestTag.
Dashboard di Axe DevTools Mobile
Screenshot mancante
Se lo screenshot manca nella pagina dei dettagli della scansione, la tua app potrebbe impedire che vengano prese gli screenshot. Spesso questo è per motivi di sicurezza nella tua applicazione in produzione. Considera la possibilità di rimuovere questo requisito per la tua build di test per consentire la piena funzionalità nel Dashboard di Axe DevTools Mobile.
Alcuni nomi di scansione di Android sono non formattati
Alcuni nomi di scansione di Android che vengono predefiniti al titolo dello schermo appariranno come il nome completo della classe incluso l'identificatore di bundle. In un prossimo rilascio, 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 dal dashboard o dai framework. (#1643)
Axe DevTools Mobile per Appium
Falso positivo: Nome vista attiva
A causa delle limitazioni delle informazioni disponibili tramite la piattaforma Appium, abbiamo identificato un falso positivo per Nome vista attiva quando si utilizza la labeledBy proprietà per fornire un'etichetta a un elemento pulsante. Stiamo esplorando soluzioni e ci aspettiamo una correzione in un futuro rilascio.
React Native e .NET MAUI: Etichetta Nel Nome & Etichetta Davanti
A causa di limitazioni nelle informazioni disponibili tramite la piattaforma Appium, abbiamo identificato che le regole Etichetta Nel Nome & Etichetta Davanti non possono essere eseguite per le app costruite con React Native. Stiamo esplorando soluzioni e ci aspettiamo una correzione in un futuro aggiornamento.
React Native: Ispeziona la Gerarchia delle Viste Mostrando la Schermata Precedente
A volte, la proprietà della sorgente pagina di Appium necessita di tempo aggiuntivo per essere aggiornata tra le scansioni. Se ciò accade, vedrai la gerarchia delle viste di una schermata precedente quando utilizzi la funzione di ispezione sul dashboard. Per risolvere, aggiungi un breve timeout prima di chiamare l'API della sorgente pagina per avviare la scansione dell'accessibilità. Esempio:
await driver.pause(1000);
const result = await driver.getPageSource();
