Impostazione per test automatizzati

Quando vuoi avere il pieno controllo su quando e dove gli esami di accessibilità vengono eseguiti nei tuoi test, dovresti implementare il Test Mirato. Segui i passaggi sottostanti per configurare la libreria AxeDevTools nei tuoi test UI per verificare i problemi di accessibilità. Richiamerai esplicitamente il metodo axe.scan() in punti specifici del tuo codice.

Test automatizzati

È richiesto XCTest per eseguire axeDevToolsXCUI. Sono supportati altri framework di test UI che utilizzano XCTest.

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 dei metodi setUp o setUpWithError.

Avvia una Sessione di Test

Genera una chiave API su axe.deque.com. Per inviare i risultati ad Axe Developer Hub, utilizza startScanSession con la Chiave API e l'ID del progetto 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 a scopo di autenticazione. Contatta il tuo rappresentante Deque o contatta il supporto per coordinare la consegna della tua chiave di licenza. Quindi utilizza il codice riportato di seguito per connetterti alla libreria axeDevTools. Vedi le FAQ per ulteriori informazioni sull'utilizzo 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 framework axeDevToolsXCUI, 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 etichettare le scansioni.