Teste Direcionado com XCTest

Quando você quer ter controle total sobre quando e onde as varreduras de acessibilidade são realizadas em seus testes, deve implementar o Teste Direcionado. Siga os passos abaixo para configurar a biblioteca AxeDevTools dentro de seus testes de UI para verificar problemas de acessibilidade. Você irá 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 UI que utilizam o 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 teste para armazenar a instância do axe DevTools:

var axe: AxeDevTools?

Inicialize o framework dentro dos métodos setUp ou setUpWithError .

Iniciar uma Sessão de Teste

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

axe = try? AxeDevTools.startSession(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.startSession(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.startSession(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 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. Em seguida, utilize o trecho abaixo para se conectar à biblioteca axeDevTools . Consulte 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 , você 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 marcar escaneamentos.