Pruebas Dirigidas con XCTest

Cuando quieras tener el control total sobre cuándo y dónde se ejecutan los escaneos de accesibilidad en tus pruebas, debes implementar Pruebas Dirigidas. Sigue los pasos a continuación para configurar la biblioteca AxeDevTools dentro de tus pruebas de UI para verificar problemas de accesibilidad. Llamarás explícitamente al método axe.scan() en puntos específicos de tu código.

Pruebas Automatizadas

XCTest es necesario para ejecutar axeDevToolsXCUI. Se admiten otros marcos de pruebas de UI que utilizan XCTest.

Configuración para Pruebas

En cualquier archivo utilizado para pruebas de accesibilidad, importa el marco axeDevToolsXCUI.

import axeDevToolsXCUI

Crea un objeto dentro de tu clase de pruebas para mantener la instancia de Axe DevTools:

var axe: AxeDevTools?

Inicializa el marco dentro de los métodos setUp o setUpWithError.

Iniciar una Sesión de Pruebas

Genera una clave API en axe.deque.com. Para publicar resultados en Axe Developer Hub, utiliza startScanSession con la Clave API y la ID del Proyecto de Developer Hub.

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

Los resultados se cargan en Axe Developer Hub de forma predeterminada. Si solo deseas guardar los resultados localmente, establece axeUploadResults en false. No necesitas incluir el ID del proyecto.

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

Ejemplo de Configuración

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 con Clave de Licencia Offline

La automatización offline está disponible para el iOS SDK, pero requerirá una clave de licencia offline para fines de autenticación. Por favor contacta a tu representante de Deque o contacta con soporte para coordinar el envío de tu clave de licencia. Luego utiliza el fragmento de código a continuación para conectarte a la biblioteca axeDevTools. Consulta las preguntas frecuentes para obtener más información sobre el uso de los SDKs Offline para un rendimiento optimizado sin solicitudes de red.

import axeDevToolsXCUI_noauth
import XCTest

class MyUITests: XCTestCase {

    var axeDevTools: AxeDevTools?

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

¿Qué sigue?

Ahora que has creado un proyecto e integrado el framework axeDevToolsXCUI, estás listo para escanear tu aplicación móvil. Opcionalmente, puedes personalizar tu configuración antes de escanear, si deseas nombrar tus escaneos, ignorar ciertos resultados, crear reglas personalizadas o etiquetar escaneos.