Note di rilascio di Axe DevTools Mobile del 20 febbraio 2025

Una configurazione nell'iOS Analyzer 1.4.7 impedisce l'esecuzione delle scansioni, restituendo il messaggio "Test Failed". Per eseguire scansioni su un dispositivo fisico, aggiorna all'ultimo progetto iOS Analyzer.

La funzionalità di test di un'applicazione tramite identificatore di bundle è stata interrotta nella versione 2.8.1, risultando in un errore intitolato "Nessun percorso dell'applicazione target specificato tramite configurazione del test: ...". Aggiorna alla 2.8.2 o all'ultima versione per risolvere l'errore. Aggiorna all'ultimo progetto iOS Analyzer.

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

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

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 aperto un bug report con Apple.

Durante l'esame di un miglioramento per le nostre regole, abbiamo scoperto che in XCTest, i controlli nidificati non vengono restituiti nell'albero di accessibilità. È stato aperto un bug report con Apple. (#1110)

Nelle app UIKit, un'immagine senza `accessibilityLabel` non è focalizzabile con assistive technology di default.
Le proprietà che usiamo per controllare la focalizzabilità di Apple potrebbero non essere accurate quando un `accessibilityIdentifier` è impostato sull'immagine. A causa di questo comportamento inatteso, i risultati per i problemi Name di ImageView nelle app UIKit verranno segnalati come Necessitano Revisione. È stato aperto un bug report con Apple. (#1633)

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

In Scroll View
Potrebbe segnalare problemi per il testo all'interno di elementi che si comportano come banner. Per rendere disponibili questi elementi a coloro che richiedono testo più grande, utilizza UILargeContentViewer. (#622)

v2.11.0 Image View Name & Active Control Name
Se una UIImageView ha un `accessibilityIdentifier` impostato ma non è focalizzabile da VoiceOver e ha controlli focalizzabili nidificati al suo interno, ActiveControlName potrebbe segnalare un falso positivo sulla UIImageView. Rimuovendo il `accessibilityIdentifier` si risolve il problema. È stato aperto un bug report 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 determinare lo stato della regola. In alcune gerarchie di visualizzazione, potrebbe essere rilevato il testo sbagliato nelle vicinanze, causando il fallimento di queste regole. (#1622)

La regola della Spaziatura degli Obiettivi di Tocco attualmente non è attiva su nessun componente slider scritto in Jetpack Compose. Al momento, non è possibile intervenire. Tuttavia, è in arrivo una soluzione!

Su Android API 30, uno dei percorsi in cui tentiamo di salvare i risultati localmente presenta un errore di autorizzazione. 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'
//    finalizedBy {
//        fetchAndroidFolderAxeReportsTask
//    }
}

In alcune app ibride e multipiattaforma, potremmo ottenere risultati inattesi 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 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, consigliamo di tenerlo disattivato per le build di test interne dove puoi utilizzare in modo sicuro dati di test ed eliminare in tal modo 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 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 comprimi la tua build, vedrai un crash con un log di errore che segnala 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)

Una build con r8 abilitato può 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, per favore utilizza le API indipendenti dal layout per continuare a ricevere aggiornamenti. Se continui a utilizzare le API di Compose e incontri un errore simile a `Expected exactly '1' node but found '2' nodes that satisfy: (isRoot)` oppure `No View initialized, did you call AxeDevToolsCompose.setComposeTestRule()?`, ti preghiamo di fare riferimento a Compose setTestTag API.

Se incontri questo messaggio, alcuni risultati delle regole potrebbero non restituire come previsto quando quella regola utilizza intelligenza artificiale. Le regole interessate includono Contrasto del Colore, Testo Focalizzabile e Nome dell'Elemento Annidato. (#841)

A causa delle limitazioni dell'architettura dell'app MAUI nel rendering nel sistema operativo Android, la regola del Nome del Testo Modi verrà mostrata come Da Revisionare nel cruscotto quando si sospetta un fallimento per la versione SDK 5.5.0 e successive. Ti preghiamo di confermare manualmente il comportamento corretto per 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 invece controllarli manualmente per assicurarsi che si comportino come desiderato con la tecnologia assistiva.

Se lo screenshot manca dalla pagina dei dettagli della scansione, la tua app potrebbe impedire la cattura degli screenshot. Spesso questo avviene per motivi di sicurezza nella tua applicazione di produzione. Considera di rimuovere questo requisito per la tua build di test per consentire la piena funzionalità nel Cruscotto Mobile di Axe DevTools.

• Android - FLAG_SECURE

Alcuni nomi di scansioni Android che vengono impostati di default sul titolo dello schermo appariranno come nome completo della classe, incluso l'identificatore del pacchetto. In una futura versione, questo problema verrà risolto in modo che il titolo dello schermo sia formattato in un nome più leggibile. Come soluzione provvisoria, puoi impostare il nome della scansione dal cruscotto o dai framework. (#1643)