Impostazione per test automatizzati

Quando desideri avere il controllo totale su quando e dove gli esami di accessibilità vengono eseguiti nei tuoi test, dovresti implementare il test mirato. Segui i passaggi seguenti per configurare la libreria AxeDevTools all'interno dei tuoi test UI per verificare eventuali problemi di accessibilità. Richiamerai esplicitamente il axe.scan() metodo in punti specifici del tuo codice.

Test automatizzati

È necessario XCTest per eseguire axeDevToolsXCUI. Altri framework di test UI che utilizzano XCTest sono supportati.

Configurazione per i Test

In qualsiasi file utilizzato per il test di accessibilità, importa il framework axeDevToolsXCUI.

import axeDevToolsXCUI

Crea un oggetto all'interno della tua classe di test per conservare l'istanza di axe DevTools:

var axe: AxeDevTools?

Inizializza il framework all'interno del setUp o nei setUpWithError metodi.

Avvia una Sessione di Test

Genera una chiave API su axe.deque.com. Per pubblicare i risultati sull'axe Developer Hub, utilizza startScanSession con la chiave API e il Project ID da Developer Hub.

axe = try? AxeDevTools.startScanSession(apiKey: "<DEQUE_APIKEY>",
            projectId: "<DEVHUB_PROJECT_ID>")

Se vuoi solo salvare i risultati localmente, non è necessario includere il Project ID.

axe = try? AxeDevTools.startScanSession(apiKey: "<DEQUE_APIKEY>")

Esempio di Configurazione

import axeDevToolsXCUI
import XCTest

class MyUITests: XCTestCase {
    var axe: AxeDevTools?
    var app = XCUIApplication()

    override func setUpWithError() throws {
        axe = try AxeDevTools.startScanSession(apiKey: "<DEQUE_APIKEY>",
            projectId: "<DEVHUB_PROJECT_ID>")
        // Include the projectId to post results to axe Developer Hub (recommended)
        app.launch()
    }
}

Connessione con Chiave di Licenza Offline

L'automazione offline è disponibile per l'SDK iOS, ma richiederà una chiave di licenza offline per scopi di autenticazione. Contatta il tuo rappresentante Deque o contatta il supporto per coordinare la consegna della tua chiave di licenza. Quindi usa lo snippet sotto per connetterti alla axeDevTools libreria. Vedi le FAQ per ulteriori informazioni sull'uso degli SDK offline per prestazioni ottimizzate senza richieste di rete.

import axeDevToolsXCUI_noauth
import XCTest

class MyUITests: XCTestCase {

    var axeDevTools: AxeDevTools?

    override func setUpWithError() throws {
        axeDevTools = AxeDevTools.loginWithLicenseKey("DEQUE_LICENSE_KEY")
    ...
}

Cosa fare dopo?

Ora che hai creato un progetto e integrato il axeDevToolsXCUI framework, sei pronto per scansionare la tua app mobile. Facoltativamente, puoi personalizzare la tua configurazione prima di eseguire la scansione, se desideri nominare le tue scansioni, ignorare determinati risultati, creare regole personalizzate o taggare le scansioni.