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 la migrazione degli early adopter alle ultime modifiche di axe DevTools Mobile per Appium.

Not for use with personal data

Nota: se hai appena iniziato a usare axe DevTools Mobile per Appium, consulta la guida all'installazione.

Grazie per il feedback! Abbiamo apportato alcune modifiche al nostro plugin Appium per servirti al meglio nella tua attuale attività di test delle app mobili. Se hai implementato la versione 1.0.0 del plugin Appium, segui questa guida per i semplici passaggi necessari per passare alla versione 2.0.0.

Aggiornamento alla versione 2.0.0

Disinstalla axeDevToolsMobile:

appium plugin uninstall axeDevToolsMobile

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

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

Aggiornare le funzionalità

Dagli script di automazione Appium, copia e rimuovi la 'capability' 'chiave' precedentemente richiesta per la chiave API di axe DevTools Mobile.

La chiave API verrà spostata in un oggetto impostazioni per essere passata al executeScript metodo di Appium.

tip

Potresti prendere in considerazione l'aggiunta di una funzione di utilità al tuo script di test come punto centrale da cui avviare una scansione di accessibilità.

Aggiornamento su Come eseguire la scansione per problemi di accessibilità

In precedenza, il plugin intercettava il metodo sorgente della pagina di Appium per verificare eventuali problemi di accessibilità. Questa opzione è stata sostituita in modo che il codice sorgente della pagina sia ancora disponibile per l'uso nei test, come prima!

Ovunque desideri avviare un test di accessibilità, sostituisci le istanze di chiamata dell'API della sorgente della pagina con API di esecuzione dello script.

executeScript("axe:scan", Settings)

Param Tipo Descrizione
Impostazioni Object Include le configurazioni richieste per axe DevTools Mobile. (Vedi Chiavi richieste nelle Impostazioni).
Sorgente della pagina String Facoltativo: se hai già acquisito il PageSource per la schermata corrente, puoi fornirlo ad axe DevTools Mobile senza sostenere nuovamente il costo della query. Nota: se noti che lo screenshot e i risultati nella dashboard non corrispondono, è possibile che PageSource sia obsoleto e non debba essere utilizzato.

Chiavi richieste nelle impostazioni

Tasto Tipo Descrizione
chiave API String Richiesto da Deque per fornire l'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. Sono disponibili esempi completi in altri linguaggi di programmazione 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)