Teste Direcionado com XCTest

Quando você deseja ter total controle sobre quando e onde as verificações de acessibilidade são executadas em seus testes, deve implementar Testes Direcionados. Siga os passos abaixo para configurar a biblioteca AxeDevTools dentro dos seus testes de IU para verificar questões de acessibilidade. Você chamará explicitamente o método axe.scan() em pontos específicos do seu código.

Teste Automatizado

XCTest é necessário para executar axeDevToolsXCUI. Outros frameworks de teste de IU que utilizam XCTest são suportados.

Configuração para Teste

Em qualquer arquivo usado para teste de acessibilidade, importe o framework axeDevToolsXCUI.

import axeDevToolsXCUI

Crie um objeto dentro da sua classe de testes para manter a instância do Axe DevTools:

var axe: AxeDevTools?

Inicialize o framework nos métodos setUp ou setUpWithError.

Iniciar uma Sessão de Teste

Gerencie uma chave de API em axe.deque.com. Para postar resultados no Axe Developer Hub, use startScanSession com a Chave de API e o ID do Projeto do Developer Hub.

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

Se você só quiser salvar os resultados localmente, não precisa incluir o ID do Projeto.

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

Exemplo de Configuração

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()
    }
}

Conectar com Chave de Licença Offline

A automação offline está disponível para o SDK do iOS, mas exigirá uma chave de licença offline para fins de autenticação. Por favor, entre em contato com seu representante Deque ou contate o suporte para coordenar a entrega da sua chave de licença. Depois, use o trecho abaixo para conectar à biblioteca axeDevTools. Veja as FAQ para mais informações sobre como usar os SDKs Offline para desempenho otimizado sem solicitações de rede.

import axeDevToolsXCUI_noauth
import XCTest

class MyUITests: XCTestCase {

    var axeDevTools: AxeDevTools?

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

O Que Vem a Seguir?

Agora que você criou um projeto e integrou o framework axeDevToolsXCUI, está pronto para escanear seu aplicativo móvel. Opcionalmente, você pode customizar sua configuração antes de escanear, se quiser nomear seus escaneamentos, ignorar certos resultados, criar regras personalizadas ou etiquetar escaneamentos.