Migrare il Plugin Appium alla versione 2.0.0

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Guida per migrare i primi utenti alle ultime modifiche di Axe DevTools Mobile per Appium.

Not for use with personal data

Nota: Se stai appena iniziando con Axe DevTools Mobile per Appium, visita la guida all'installazione.

Grazie per il feedback! Abbiamo apportato alcune modifiche al nostro Plugin Appium per servirti meglio e per come stai testando le app mobili oggi. Se hai implementato la versione 1.0.0 del Plugin Appium, segui questa guida per passare facilmente alla versione 2.0.0.

Aggiornamento alla versione 2.0.0

Disinstalla axeDevToolsMobile:

appium plugin uninstall axeDevToolsMobile

Una nuova installazione del plugin scaricherà la versione più recente. Installa il plugin nella tua istanza Appium tramite la riga di comando:

appium plugin install --source=npm @axe-devtools/appium-plugin

Aggiorna le Capacità

Dai tuoi script di automazione Appium, copia e poi rimuovi la capacità 'chiave' precedentemente richiesta per la chiave API di Axe DevTools Mobile.

La chiave API verrà spostata in un oggetto di impostazioni da passare nel metodo executeScript di Appium.

tip

Potresti considerare di aggiungere una funzione utility al tuo script di test come luogo centrale per avviare una scansione di accessibilità.

Aggiorna Come Scansionare per Problemi di Accessibilità

In precedenza, il plugin intercettava il metodo source page di Appium per verificare la presenza di problemi di accessibilità. Questo è stato sostituito in modo che il source page sia ancora disponibile per l'uso nei test come fatto in precedenza!

Ovunque desideri avviare un test di accessibilità, sostituisci le istanze di chiamata del API del source page con API execute script.

executeScript("axe:scan", Settings)

Parametro	Tipo	Descrizione
Settings	`Object`	Include le configurazioni richieste per Axe DevTools Mobile. (Vedi Chiavi Necessarie nelle Impostazioni).
PageSource	`String`	Opzionale: Se hai già catturato la PageSource per lo schermo attuale, puoi fornirla ad Axe DevTools Mobile senza ripetere il costo della query. Nota: Se noti che lo screenshot e i risultati non corrispondono nella dashboard, la PageSource potrebbe essere obsoleta e non dovrebbe essere usata.

Chiavi Necessarie nelle Impostazioni

Chiave	Tipo	Descrizione
apiKey	`String`	Richiesta da Deque per fornire accesso agli utenti autorizzati. Accedi alla tua chiave API di Axe DevTools Mobile nel portale Account Axe.

Esempi

Ecco un esempio delle modifiche evidenziate sopra. Esempi completi sono disponibili in altre lingue client.

Esempio in Python

def runAccessibilityScan(self):
    settings = {}
    settings['apiKey'] = "<your-api-key-here>"
    return self.driver.execute_script('axe:scan', settings)

Esempio con PageSource in Python

def runAccessibilityScan(self):
    settings = {}
    settings['apiKey'] = "<your-api-key-here>"
    pageSource = self.driver.page_source
    return self.driver.execute_script('axe:scan', settings, pageSource)