Preguntas Frecuentes

Android

Analizador Móvil

Pruebas Automatizadas

Ofrecemos compilaciones offline de nuestros SDKs y controladores Appium para tu flujo de automatización que no requieren ninguna solicitud de red al servicio Axe DevTools Mobile. Como tal, estas configuraciones de compilación solo están disponibles a través de Artifactory de Deque.

Por favor, ten en cuenta que esta compilación es un subconjunto de las capacidades dentro de Axe DevTools Mobile para Android. Para utilizar el conjunto completo de capacidades, incluyendo enviar resultados al panel, por favor usa nuestros SDKs estándar o controladores Appium. Consulta el guía de primeros pasos.

Setup

Mientras navegas por la documentación, ten en cuenta que no todas las funciones que requieren interacción con el servidor están disponibles en la compilación offline.

Configuración para Pruebas

En el application's build.gradle archivo, añade:

android {
    packagingOptions {
        exclude 'META-INF/DEPENDENCIES'
        exclude 'META-INF/AL2.0' 
        exclude 'META-INF/LGPL2.1'
    }
}

Asegúrate de que hay permiso de Internet en el AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />

Ejemplo de Prueba Espresso

Ten en cuenta que el axe.loginWithUsername(...) y el axe.loginWithApiKey(...) no están disponibles en esta versión de la biblioteca y deben ser eliminados del código de configuración si estás convirtiéndote de usar la versión autenticada.

Independiente del Diseño

@RunWith(AndroidJUnit4::class)
class ExampleInstrumentedTest {
    @Rule    
    @JvmField    
    var rule: ActivityScenarioRule<MainActivity> = ActivityScenarioRule(MainActivity::class.java)

    companion object {
        private val axe = AxeDevTools()
        init {
            axe.setOfflineLicenseKey("deque_provided_license_key_here")
        }
        axe.setInstrumenation(InstrumentationRegistry.getInstrumentation())
    }

    @Test    
    fun exampleTest() {
        onView(withText("Example Button Name")).perform(click())
    }

    @After    
    fun runAccessibilityScan() {
        val scan = axe.scan()
        val result = scan?.getSerializedResult()

        axe.tearDown()   
    }
}

Resultados

iOS

Analizador Móvil

Solución rápida

1. Abre Xcode → Ve a Xcode > Settings (o Preferences en versiones anteriores)
2. Selecciona la pestaña Accounts Selecciona tu
3. Haz clic en Apple ID
4. Click Manage Certificates
5. Encuentre el certificado caducado (tendrá un ícono de advertencia)
6. Selecciona el certificado caducado y haz clic en el botón menos (−) para eliminarlo
7. Haz clic en el botón más (+) y selecciona Apple Development para crear un nuevo certificado
8. Cierra la aplicación del Analizador Móvil
9. Lanza la aplicación nuevamente. Consulta el Prueba de aplicaciones iOS para accesibilidad si es necesario

¿Sigue recibiendo un error?

A veces, Xcode almacena en caché el certificado antiguo. Intente lo siguiente:

1. Revoque el certificado en su cuenta de desarrollador de Apple:
   • Ve a developer.apple.com
   • Navega a Certificates, Identifiers & Profiles
   • Encuentra el certificado expirado y revócalo
   • Regresa a Xcode y repite los pasos anteriores para crear uno nuevo
2. Borrar datos derivados:
   • En Xcode: Window > Organizer > Projects pestaña
   • Selecciona tu proyecto y haz clic en Delete junto a Derived Data
3. Reinicia Xcode después de realizar estos cambios

1. Obtén el UDID (Identificador Único de Dispositivo) de tu dispositivo:
   • Conecta tu iPhone a tu Mac
   • Abre Finder (macOS Catalina o posterior) o iTunes (versiones anteriores)
   • Selecciona tu dispositivo y haz clic en el número de serie hasta que muestre el UDID
   • Haz clic derecho y copia el UDID
   • Alternativamente, puedes abrir Xcode: Window > Devices and Simulators, selecciona tu dispositivo y copia el identificador
2. Agrega el dispositivo a tu cuenta de Desarrollador:
   • Ve a developer.apple.com e inicia sesión
   • Navega a Certificates, Identifiers & Profiles
   • Seleccionar Devices desde la barra lateral
   • Haz clic en el signo más (+) para registrar un nuevo dispositivo
   • Introduce un nombre para tu dispositivo y pega el UDID
   • Haz clic en Continue y luego en Register
3. Reiniciar el Analizador Móvil:
   • Cierra la aplicación del Analizador Móvil
   • Lanza la aplicación de nuevo. Consulta Prueba de aplicaciones iOS para accesibilidad si es necesario

Ten en cuenta que las cuentas gratuitas de desarrolladores de Apple pueden registrar hasta 3 dispositivos, mientras que las cuentas de pago pueden registrar hasta 100 dispositivos por tipo de dispositivo (100 iPhones, 100 iPads, etc.).

Pruebas Automatizadas

Ofrecemos compilaciones offline de nuestros SDKs y controladores de Appium para tu pipeline de automatización que no requieren solicitudes de red al servicio de Axe DevTools Mobile. Como tal, estas configuraciones de compilación solo están disponibles a través de Artifactory de Deque.

Ten en cuenta que esta compilación es un subconjunto de capacidades dentro de axeDevToolsXCUI. Para usar el conjunto completo de capacidades, incluidas el envío de resultados al tablero, por favor utiliza nuestro marco axeDevToolsXCUI. Consulta la guía de configuración.

Configuración

1. Importa el marco en cualquier archivo utilizado para pruebas de accesibilidad.

import axeDevToolsXCUI_noauth

2. Cree un objeto dentro de su clase de prueba para almacenar la instancia de Axe DevTools:

var axeDevTools: AxeDevTools?

3. Inicialice el framework dentro de los métodos setUp o setUpWithError.

axeDevTools = AxeDevTools.startScanSession()

Ejemplo completo de configuración

import axeDevToolsXCUI_noauth
import XCTest

class MyUITests: XCTestCase {

    var axeDevTools: AxeDevTools?

    override func setUpWithError() throws {
        axeDevTools = AxeDevTools.loginWithLicenseKey("deque_provided_license_key_here") // does this change??
    }
    ...
}

Pruebas de UI

Para comenzar a probar, pase cualquier XCUIElement al framework para ejecutar pruebas de accesibilidad contra él y sus hijos.

let result = try axeDevTools.run(onElement: XCUIApplication())

Ejemplo completo

import XCTest
import axeDevToolsXCUI_noauth

final class XCUI_noAuthUITest: XCTestCase {
    var axeDevTools: AxeDevTools = AxeDevTools.startScanSession()

    override func setUpWithError() throws {
        continueAfterFailure = false
    }

    func testExample() throws {
        let app = XCUIApplication()
        app.launch()

        let result = try axeDevTools.run(onElement: app)
        // Do something with the result
    }
}

¿Qué sigue?

Te damos los datos y herramientas para crear un flujo de trabajo CI/CD que ayude a tu equipo. Aquí tienes algunas sugerencias sobre qué hacer con ese objeto de resultado:

1. Falla la compilación si se encontraron errores. Si tienes una pantalla que ya ha sido limpiada de problemas de accesibilidad, es posible que quieras asegurarte de que no aparezcan nuevos durante el ciclo de desarrollo afirmando que el conteo es 0 y fallando la verificación del estado de la solicitud de extracción si no es así.

// Add an assertion to fail the build if issues were found
XCTAssertTrue(result.failures.count > 0)

2. Guarda los resultados localmente para crear un informe delimitado de los problemas encontrados en la rama. Consulte cómo crear un informe con nuestro CLI de Reporter para pipelines CICD. Esto puede ser muy útil para versiones candidatas de lanzamiento o ramas beta para dar a conocer qué posibles obstáculos pueden enfrentar los clientes que usan tecnología asistiva.

Resultados

¿Busca su ID de proyecto? Puede acceder a este desde la página principal de Proyectos en Axe Developer Hub.

• Vaya a 'Configuración' de su proyecto y seleccione 'Configurar proyecto'.
• En los 'Detalles del proyecto' puede encontrar y copiar el ID de proyecto.
• Asegúrese de haber proporcionado este ID de proyecto al startScanSession método.