Impostazione per test automatizzati

Quando desideri avere il controllo totale su quando e dove eseguire le scansioni di accessibilità nei tuoi test, dovresti implementare il Test mirato. Segui i passaggi seguenti per configurare la libreria AxeDevTools nei tuoi test UI per verificare i problemi di accessibilità. Chiama esplicitamente il metodo axe.scan() in punti specifici del tuo codice.

Nota: Questo presuppone che tu abbia già aggiunto la libreria al tuo progetto. Per i passaggi per installare il plugin Gradle, consulta Primi passi.

Test automatizzati

Inizializzare la libreria

Nella classe del test init, connettiti alla libreria con uno dei seguenti metodi:

Avviare una sessione di test

Genera una chiave API su axe.deque.com. Per pubblicare i risultati su Axe Developer Hub, utilizza startScanSession con la Chiave API e l'ID Progetto da Developer Hub.

private val axe = AxeDevTools()

init {
  ...
  axe.startScanSession(apiKey = "<DEQUE_APIKEY>",
            projectId = "<DEVHUB_PROJECT_ID>")
  ...
}

Se desideri solo salvare i risultati localmente, non è necessario includere l'ID Progetto.

private val axe = AxeDevTools()

init {
  ...
  axe.startScanSession(apiKey = "<DEQUE_APIKEY>")
  ...
}

Connettersi con la chiave di licenza offline

L'automazione offline è disponibile per l'SDK Android, ma richiederà una chiave di licenza offline per l'autenticazione. Si prega di contattare il tuo rappresentante Deque o contatta il supporto per coordinare la consegna della chiave di licenza. Quindi, utilizza il frammento di codice seguente per connetterti alla libreria axeDevTools. Vedi le FAQ per ulteriori informazioni sull'uso degli SDK offline per prestazioni ottimizzate senza richieste di rete.

val axe = AxeDevTools()

init {
    axe.setOfflineLicenseKey("OFFLINE_LICENSE_KEY")
}

Impostare il Registro di Strumentazione

Questo è il componente che consente ad Axe DevTools per Android di connettersi alla gerarchia delle viste. Può essere impostato prima che i tuoi test vengano eseguiti nel blocco @Before fun setup().

private val axe = AxeDevTools()

@Before
fun setup()  {
  axe.setInstrumentation(InstrumentationRegistry.getInstrumentation())
}

Cosa fare dopo?

Ora che hai creato un progetto e importato la libreria AxeDevTools, sei pronto per scansionare la tua app mobile. Facoltativamente, puoi personalizzare la tua configurazione prima di eseguire la scansione, utilizzando le nostre API per nominare le tue scansioni, ignorare determinati risultati, creare regole personalizzate, etichettare le scansioni e altro ancora.