Migrare il plugin Appium alla versione 2.0.0
Guida per la migrazione degli early adopter alle ultime modifiche di axe DevTools Mobile per Appium.
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.
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)