Generar informes dentro de CI/CD

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

Con Axe DevTools Reporter, ahora puedes generar informes autónomos directamente dentro de tu flujo de integración continua / implementación continua (CI/CD).

Sigue los pasos básicos a continuación para integrar el generador de informes en tu flujo de trabajo de Android o iOS.

Integración en un flujo de Android

Configura tus pruebas automatizadas

  1. Actualiza tus pruebas automatizadas para guardar resultados localmente, que luego se pueden usar para generar el informe.

  2. Agrega el siguiente script al archivo build.gradle de tu aplicación, debajo del bloque android, y asegúrate de que no esté dentro de otra tarea de Gradle. Añade el nombre del paquete de tu aplicación en la variable packageName. Este script moverá los resultados generados de tu ejecución automatizada al directorio de informes de la carpeta de construcción.

def reportsDirectory = "$buildDir/reports/androidTests/connected/axe"
def packageName = "your.app.package.name.here"

def createAndroidFolderDirectoryTask = task('createAndroidFolderDirectoryTask', type: Exec, group: 'reporting') {
    executable "${android.getAdbExecutable().toString()}"
    args 'shell', 'mkdir', '-p', '/storage/emulated/0/Android/data/' + packageName + '/files/AxeTestCases'
}

def clearAndroidDirectoryTask = task('clearAndroidDirectoryTask', type: Exec, group: 'reporting') {
    executable "${android.getAdbExecutable().toString()}"
    args 'shell', 'rm', '-r', '/storage/emulated/0/Android/data/' + packageName + '/files/AxeTestCases'
}

def fetchAndroidFolderAxeReportsTask = task('fetchAndroidFolderAxeReportsTask', type: Exec, group: 'reporting') {
    executable "${android.getAdbExecutable().toString()}"
    args 'pull', '/storage/emulated/0/Android/data/' + packageName + '/files/AxeTestCases', reportsDirectory

    dependsOn {
        createAndroidFolderDirectoryTask
    }

    finalizedBy {
        clearAndroidDirectoryTask
    }

    doFirst {
        new File(reportsDirectory).mkdirs()
    }
}

def createDirectoryTask = task('createDirectoryTask', type: Exec, group: 'reporting') {
    executable "${android.getAdbExecutable().toString()}"
    args 'shell', 'mkdir', '-p', '/storage/emulated/0/Documents/AxeTestCases'
}

def clearDirectoryTask = task('clearDirectoryTask', type: Exec, group: 'reporting') {
    executable "${android.getAdbExecutable().toString()}"
    args 'shell', 'rm', '-r', '/storage/emulated/0/Documents/AxeTestCases'

    finalizedBy {
        fetchAndroidFolderAxeReportsTask
    }
}

def fetchAxeReportsTask = task('fetchAxeReportsTask', type: Exec, group: 'reporting') {
    executable "${android.getAdbExecutable().toString()}"
    args 'pull', '/storage/emulated/0/Documents/AxeTestCases', reportsDirectory

    dependsOn {
        createDirectoryTask
    }

    finalizedBy {
        clearDirectoryTask
    }

    doFirst {
        new File(reportsDirectory).mkdirs()
    }
}

tasks.configureEach { task ->
    if (task.name == 'connectedDebugAndroidTest') {
        task.finalizedBy {
            fetchAxeReportsTask
        }
    }
}

Pasos para generar el informe

  1. Inicia sesión en nuestro almacén privado, Agora, con tus credenciales de Deque.
  2. Desde el menú desplegable "Bienvenido, <tu_email>", selecciona «Editar perfil».
  3. Haz clic en 'Generar un Token de Identidad'.
  4. Se abrirá un cuadro de diálogo y mostrará la opción de copiar el Token de Referencia.
  5. Crea un nombre distintivo para el Token de Identidad y añádelo en la descripción. El ejemplo a continuación utiliza AGORA_IDENTITY_TOKEN como nombre.
  6. Selecciona 'Siguiente'.
  7. En el siguiente cuadro de diálogo, copia tu Token de Identidad para utilizarlo en el script a continuación. Para un flujo automatizado, considera tener este token disponible en tus variables de entorno o secretos del proyecto para tu plataforma.
note

El Token de Identidad es accesible solo dentro del diálogo y no podrás verlo nuevamente después de cerrar el diálogo. Este token expirará 11 meses y 30 días después de su creación.

  1. Antes de ejecutar tus pruebas o compilar, obtén el generador de informes. Aquí tienes un script para comenzar:
    # Compatible with a Mac runner on GitHub Actions. Make changes to the Reporter download type and location based on your pipeline requirements.
    AGORA_IDENTITY_TOKEN='<YOUR_AGORA_IDENTITY_TOKEN>'
    curl --compressed \
         -H "X-JFrog-Art-Api: ${AGORA_IDENTITY_TOKEN}" \
        "https://agora.dequecloud.com/artifactory/axe-devtools-reporter-cli/prod/4.11.1/pkgs/@axe-devtools/reporter-cli-macos" \
         --output "/Users/runner/reporter"
    chmod +x /Users/runner/reporter

  1. Compila tu aplicación y ejecuta tus pruebas

  2. Una vez que las pruebas hayan terminado, ejecuta el generador de informes y especifica la ruta de los archivos JSON de resultados.

    DEQUE_RESULTS="../ContainingFolder"
    /Users/runner/reporter ${DEQUE_RESULTS} "AxeReport" --format=html
tip

Personaliza tu formato de salida (--format) con html, junit o csv.

Integración en un flujo de iOS

Configura tus pruebas automatizadas

Actualiza tus pruebas automatizadas para guardar resultados localmente, que luego se pueden usar para generar el informe.

Pasos para generar el informe

  1. Inicia sesión en nuestro almacén privado, Agora, con tus credenciales de Deque.
  2. Desde el menú desplegable "Bienvenido, <tu_email>", selecciona «Editar perfil».
  3. Haz clic en 'Generar un Token de Identidad'.
  4. Se abrirá un cuadro de diálogo y mostrará la opción de copiar el Token de Referencia.
  5. Crea un nombre distintivo para el Token de Identidad y añádelo en la descripción. El ejemplo a continuación utiliza AGORA_IDENTITY_TOKEN como nombre.
  6. Selecciona 'Siguiente'.
  7. En el siguiente cuadro de diálogo, copia tu Token de Identidad para utilizarlo en el script a continuación. Para un flujo automatizado, considera tener este token disponible en tus variables de entorno o secretos del proyecto para tu plataforma.
note

El Token de Identidad es accesible solo dentro del diálogo y no podrás verlo nuevamente después de cerrar el diálogo. Este token expirará 11 meses y 30 días después de su creación.

  1. Antes de ejecutar tus pruebas o compilar, obtén el generador de informes. Aquí tienes un script útil para comenzar:
    AGORA_IDENTITY_TOKENY='<YOUR_AGORA_IDENTITY_TOKEN>'
    curl --compressed \
         -H "X-JFrog-Art-Api: ${AGORA_IDENTITY_TOKEN}" \
        "https://agora.dequecloud.com/artifactory/axe-devtools-reporter-cli/prod/4.11.1/pkgs/@axe-devtools/reporter-cli-macos" \
         --output "/Users/runner/reporter"
    chmod +x /Users/runner/reporter

  1. Compila tu aplicación y ejecuta tus pruebas.

  2. Una vez que las pruebas hayan terminado, ejecuta el generador de informes y especifica la ruta de los archivos JSON de resultados.

    DEQUE_RESULTS="../ContainingFolder"
    /Users/runner/reporter ${DEQUE_RESULTS} "AxeReport" --format=html
tip

Personaliza tu formato de salida (--format) con html, junit o csv.

Is this page helpful?

Help us improve this page

Still need help?