Note di rilascio di Axe DevTools Mobile dell'11 dicembre 2024

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

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

C'è un problema che riguarda il simulatore iPhone 15 Pro che impedisce l'esecuzione della regola Supports Dynamic Type. Se hai optato per la regola Supports Dynamic Type, non potrai testarla utilizzando un simulatore iPhone 15 Pro. Un bug è stato segnalato ad Apple.

Quando abbiamo esaminato un miglioramento per le nostre regole, abbiamo scoperto che in XCTest, i controlli nidificati non vengono restituiti nell'albero dell'accessibilità. Un bug è stato segnalato ad Apple. (#1110)

Nelle app UIKit, un'immagine senza un `accessibilityLabel` non è focalizzabile con tecnologie assistive per impostazione predefinita.
Le proprietà che usiamo per controllare la focalizzabilità da Apple potrebbero essere inaccurate quando un `accessibilityIdentifier` è impostato sull'immagine. A causa di questo comportamento inatteso, i risultati per i problemi di ImageView Name nelle app UIKit verranno riportati come Needs Review. Un bug è stato segnalato ad Apple. (#1633)

Stiamo lavorando attivamente su correzioni per i seguenti falsi positivi e aggiorneremo questa lista man mano che verranno rilasciate le correzioni.

In Scroll View
Potrebbero essere riportati problemi per il testo all'interno di elementi che si comportano come banner. Per rendere questi elementi disponibili a chi richiede un 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 annidati all'interno, ActiveControlName potrebbe segnalare un falso positivo sull'UIImageView. Rimuovere il `accessibilityIdentifier` risolve il problema. Un bug è stato segnalato 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 aiutare a determinare lo stato della regola. In alcune gerarchie di viste, potrebbe essere rilevato il testo vicino errato causando il fallimento di queste regole. (#1622)

Introdotta con API 31 (Android 12) è la capacità di nascondere overlay 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 alla sicurezza, ti consigliamo di lasciarla disattivata per le build di test interne dove puoi utilizzare in sicurezza i dati di testing 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 eventuali chiamate al metodo setHideOverlayWindows(true) a setHideOverlayWindows(false) sulle finestre delle attività interessate.

Per sbloccare tutte le funzionalità di Axe DevTools per Mobile, assicurati che gli screenshot siano abilitati. Consigliamo di abilitare gli screenshot su una versione di debug o di test della tua app che utilizza dati fittizi per evitare problematiche di sicurezza. Consulta la nostra guida per abilitare gli screenshot nelle app Android.

Se minifichi la tua build, vedrai un arresto anomalo con un log di errore che riporta che un adattatore non può essere trovato quando si tenta di accedere alla libreria Axe DevTools. Disabilita la minifiy per le tue build di debug con Axe DevTools implementato. (#729)

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)
    

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 del tipo `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 come previsto quando quella regola utilizza l'intelligenza artificiale. Le regole interessate includono Contrasto di Colore, Testo Focalizzabile e Nome Elemento Annidato. (#841)

A causa delle limitazioni dell'architettura delle app MAUI nel sistema Android, la regola Nome Testo Modificabile verrà mostrata come Da Revisionare nel dashboard quando si sospetta un errore per la versione SDK 5.5.0 e successive. Conferma manualmente il corretto comportamento 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, ma di controllarli manualmente per garantire 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 questo accade 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 Dashboard Mobile di Axe DevTools.

• Android - FLAG_SECURE

Alcuni nomi di scansione Android che si predefiniscono al titolo dello schermo appariranno come il nome completo della classe incluso l'identificatore del pacchetto. In un futuro aggiornamento, questo problema verrà 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)