Note sulla versione di Axe DevTools Mobile - 11 novembre 2026

Versioni dei componenti

iOS

• iOS SDK (axeDevToolsXCUI v5.0.0)

Come aggiornare: iOS SDK, App desktop iOS Analyzer

Android

• Android SDK (axe-devtools-android v10.0.0)
• Plugin Gradle per Android (axe-devtools-android-plugin v2.0.0)
• Android Analyzer (Axe Accessibility Analyzer v4.2.0)

Come aggiornare: Plugin Gradle per Android, Android Analyzer

Novità?

SDK

Con l'approssimarsi del ritiro della Dashboard Mobile, la configurazione delle regole globali è ora impostata su Axe Account. Qui gli amministratori configurano le impostazioni per quali regole verranno eseguite nei test automatizzati e possono anche concedere permessi agli utenti per ignorare impostazioni globali e ignorare regole individuali nei loro test. Quando non sono consentiti interventi, l'ignora call non fa nulla e l'SDK registra il motivo. Si noti che se le impostazioni dell'organizzazione non possono essere lette, le scansioni verranno comunque eseguite. Ogni regola viene eseguita e sono consentiti gli ignora a livello di codice. Solo un'organizzazione che disattiva esplicitamente le sovrapposizioni le blocca.

iOS

• Trova un link ai tuoi risultati dopo il caricamento. Dopo che una scansione viene caricata, il registro stampa ora View your results in Axe Developer Hub: <link>. Le scansioni mirate collegano alla pagina del progetto, e Auto Scan si collega alla sua sessione.
• Le regole sono ora ignorate su AxeDevTools stesso, per esempio axe.ignoreRules(.colorContrast, .screenTitle), o per elemento con ignoreRules(onElementWithId:) / ignoreRules(onElementOfClass:). Una regola scritta male ora fallisce la build invece di eseguirsi silenziosamente. (Interruzione — vedi sotto.)

Android

• Trova un link ai tuoi risultati dopo il caricamento. Dopo che una scansione viene caricata, il registro stampa un link a Axe Developer Hub. Le scansioni mirate collegano alla pagina del progetto, e AutoScan si collega alla sua sessione.
• Ora ignori le regole con l'enumerazione AxeRuleName, per esempio axeDevTools.ignoreRules(AxeRuleName.COLOR_CONTRAST, AxeRuleName.SCREEN_TITLE). Per saltare le regole su un elemento, usa ignoreRulesOnElementWithId("resource_id", AxeRuleName.TOUCH_TARGET_SIZE). Un nome di regola scritto male ora fallisce la build invece di essere ignorato silenziosamente. (Interruzione, vedi sotto.)
• Imposta le ignora regole una volta per sessione quando esegui test mirati. Passa ignoreRules e ignoreRulesOnElementIds alla funzione mobile: axeStartSession; questi si applicano a ogni scansione mirata fino alla fine della sessione. (Nota: Auto Scan non consente ignora regole individuali; segue solo le impostazioni delle regole dell'organizzazione.)

Correzioni

iOS

• Miglioramenti all'accuratezza delle seguenti regole: Label in Name, Label at Front, Touch Target Size, Touch Target Spacing
• Le scansioni non si bloccano più quando il test runner è costruito con Xcode 16.2 o altre versioni precedenti a 16.4
• Log di test più silenziosi - l'SDK non stampa più nei log del test ogni volta che invia analytics

Android

• Accuratezza migliorata della regola Label in Name
• Prestazioni migliorate per Auto Scan - il test runner ora aspetta fino a 10 secondi per una rete prima di accedere
• Prestazioni migliorate per il pulsante di scansione flottante di Axe Accessibility Analyzer quando si utilizza TalkBack - ora puoi raggiungerlo scorrendo, e mantiene il focus dopo una scansione o dopo aver aperto un menu (Il focus di scorrimento richiede la versione 16.2 o successiva di TalkBack)

Aggiornamenti

Android

• L'SDK, l'Analyzer e i target di esempio ora costruiscono contro Android SDK 37 (compileSdk / targetSdk 37). Il minSdk rimane a 26. La tua app non necessita di modifiche.
• I test Java ora possono chiamare AxeAutoScan.skipScan(...) direttamente, senza .Companion
• resetIgnoredRules() non è più deprecato e puoi continuare a usarlo

Deprecazioni e Rimozioni

iOS

• La regola Inaccessible Action è stata rimossa. Le scansioni non la eseguono mai e AxeRuleId.InaccessibleAction non compila più. Rimuovi ogni riferimento a questa regola dal tuo codice di test - Qualsiasi codice aggiunto per disabilitare o ignorare la regola può essere eliminato.
• Le API delle regole sperimentali sono state rimosse. La chiave experimental è anche sparita dal JSON esportato.
• La chiave optInToSupportsDynamicType è stata rimossa. Se ancora l'hai nel tuo codice, elimina la linea che la imposta.
• Le seguenti API della dashboard mobile sono ora state rimosse. Erano deprecate in una versione precedente. Il percorso Axe Developer Hub è l'unico rimasto:
  • getResult, tagResult, deleteResult, updateScanName, AxeDevToolsResultKey, AxeResult.tags — rimosso, nessuna sostituzione.
  • login(withAPIKey:toServer:) e startSession(apiKey:url:projectId:) — usa startScanSession(...) o authenticate(...) invece.
  • postResult(_:withTags:withScanName:) — usa postResult(_:withScanName:), che ora non restituisce nulla.
  • axeServiceUrl / axeServerUrl (per Auto Scan) — usa axeAccountUrl.
  • AxeStatus.IGNORED - rimosso. Le regole ignorate non producono più alcun risultato, quindi "status":"IGNORED" non appare mai nel JSON esportato.

Android

• Le regole sperimentali sono state rimosse:
  • NestedElementName e NestedActiveControl non esistono più.
  • ignoreExperimental() e il flag experimental su AxeRule sono spariti.
• AxeRuleViewHierarchy è stato deprecato a marzo 2025 ed è stato ora rimosso. Le regole personalizzate dovrebbero estendere AxeRule e sovrascrivere isApplicable / runRule usando AxeView.
• Le API della dashboard mobile sono state rimosse. Axe Developer Hub è ora l'unico percorso di caricamento:
  • loginWithApiKey(...) e startSession(apiKey, projectId, serverUrl) — usa startScanSession(apiKey, projectId, axeAccountUrl).
  • tagScanAs, getResult, deleteResult, AxeDevToolsResultKey, TagsSet — rimossi, senza sostituzione.
• ScanResultHandler.uploadToDashboard(uploadOnly) — usa uploadToDashboard() senza argomenti. Nota: Questo invia i risultati a Axe Developer Hub.
• Plugin Gradle axeServerUrl — usa axeAccountUrl.
• AxeStatus.IGNORED - rimosso. Le regole ignorate non producono più alcun risultato, quindi "status":"IGNORED" non appare mai nel JSON esportato.

Modifiche significative

iOS

• La versione minima di iOS richiesta è ora la 17. I target di test UI che puntano ancora a iOS 16 devono alzare il loro target di distribuzione. L'esecuzione su dispositivi iOS 16 non è più supportata.
• L'ignoranza delle regole è stata spostata da axe.configuration, e axe.configuration è stato rimosso. Le vecchie chiamate non compilano con un messaggio che nomina la nuova chiamata:
  • axe.configuration.ignore(rules:) - usa axe.ignoreRules(...)
  • axe.configuration.ignore(rulesFor:) - usa axe.ignoreRules(onElementWithId:_:) o ignoreRules(onElementOfClass:_:)
  • axe.configuration.customRules.insert(rule) - usa axe.addCustomRule(rule)
  • Ignorare le regole personalizzate e riattivare una regola non è più supportato
• I valori di AxeRuleId sono ora in lowerCamelCase (per esempio .ColorContrast diventa .colorContrast). Il codice Swift che utilizza la vecchia ortografia non compila più. Objective-C, JSON esportato, Axe Developer Hub e le impostazioni di Appium ignoreRules sono invariate.
• Gli URL account http:// vengono rifiutati quando si accede con una chiave API. I clienti on-prem il cui URL account inizia con http:// devono passare a https://.
• Le API rimosse elencate sotto Deprecazioni e Rimozioni non compilano.

Android

• Le API di ignoranza delle regole sono cambiate. Le vecchie chiamate non compilano più:
  • ignoreRules(listOf("ColorContrast")) - usa ignoreRules(AxeRuleName.COLOR_CONTRAST)
  • ignoreByViewIdResourceName(id, listOf(...)) - usa ignoreRulesOnElementWithId(id, AxeRuleName.X, ...)
  • ignoreExperimental() - rimuovi la chiamata.
• TouchSizeWcag è ora TouchTargetSize, che corrisponde a iOS e Axe Developer Hub. Aggiorna qualsiasi codice, filtro o dashboard che cerca il vecchio nome.
• Le regole personalizzate che estendono AxeRuleViewHierarchy, o che passano il flag experimental a AxeRule, non compilano più.
• Plugin Gradle: le build che impostano ancora axeServerUrl nel blocco axeDevTools { } devono passare a axeAccountUrl.
• Le API rimosse elencate sotto Deprecazioni e Rimozioni non compilano.

Problemi noti

Nuovi Problemi

Se riscontri uno dei problemi elencati di seguito, ti preghiamo di contattarci a helpdesk@deque.com o support.deque.com. Potremo quindi informarti quando sarà risolto o di una soluzione alternativa identificata se non elencata.

iOS

Falsi positivi per le regole del Supporto a Dynamic Type e del Testo Tagliato

Le regole del Supporto a Dynamic Type e del Testo Tagliato (iOS 17 e versioni successive) utilizzano i risultati dell'audit di accessibilità di Apple. Tale audit segnala occasionalmente testo che si scala correttamente o è completamente visibile, e queste regole riportano ciò che Apple restituisce. La maggior parte dei fallimenti di queste regole sono problemi reali, quindi non consigliamo di ignorarli tutti insieme. Questo problema è stato segnalato ad Apple e stiamo lavorando per ridurre questi falsi positivi.

Per confermare un fallimento, attiva Dimensioni Accessibilità Maggiori sotto Settings > Accessibility > Display & Text Size > Larger Text. Passa attraverso ogni dimensione di testo, dalla predefinita alla più grande, e verifica che il testo segnalato si scali e rimanga completamente visibile. Il testo può apparire corretto alla dimensione più grande ma avere problemi a una dimensione intermedia.

Se il fallimento è un falso positivo, ignora la regola su quell'elemento utilizzando il suo identificatore di accessibilità. Non consigliamo di ignorare la regola per l'intera scansione o per nome di classe, poiché ciò potrebbe nascondere anche fallimenti reali.

Android

Falsi positivi durante la scansione delle mappe

Attualmente non è possibile determinare con precisione se un elemento sullo schermo è contenuto all'interno di una mappa, pertanto le nostre regole potrebbero scansionare involontariamente puntine delle mappe e fornire risultati falsi positivi. Questo è un problema su come il sistema Android segnala le mappe al Servizio di Accessibilità.

Usa la nostra API di ignora regole per esentare la tua mappa o le tue puntine delle mappe dalla scansione utilizzando i loro ID.

Scopri di più su ignorare le regole.

Le app costruite con Unity non possono essere scansionate

Axe DevTools Mobile non può scansionare il contenuto sullo schermo delle app costruite con il motore di gioco Unity. Questo influisce sulle scansioni automatizzate con la libreria Android così come sulle scansioni dall'app Accessibility Analyzer. I risultati mostrano solo i controlli a livello di schermo - per regole come Orientamento dello Schermo e Titolo dello Schermo - e niente per i pulsanti, il testo o gli interruttori dell'app.

Non esiste attualmente una soluzione alternativa.

Problemi Risolti

iOS

Rimosso: falso positivo obsoleto per Nome Visualizzazione Immagine e Nome Controllo Attivo

Abbiamo rimosso una voce obsoleta sui falsi positivi del Nome Controllo Attivo su un UIImageView che ha un accessibilityIdentifier. Questo problema interessava solo la versione v2.11.0 ed è stato risolto nel rilascio di giugno 2024. Nome Controllo Attivo non funziona più su queste immagini nelle app UIKit. Nome Visualizzazione Immagine le riporta invece come Da Revisionare (vedi Risultati della revisione della regola dei nomi di ImageView per le app UIKit).