Generar informes en 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 puede generar informes autónomos directamente dentro de su canal de integración continua/implementación continua (CI/CD).

Siga los pasos básicos a continuación para integrar el reporter en su pipeline de Android o iOS.

Integración en un pipeline de Android

Configura tus pruebas automatizadas

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

  2. Agregue el siguiente script al archivo build.gradle de su aplicación, debajo del bloque android, y asegúrese de que usted no lo coloque dentro de otra tarea de Gradle. Agregue el nombre del paquete de su aplicación en la packageName variable. Este script moverá los resultados generados por su ejecución automatizada al directorio de informes de la carpeta de compilació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. Inicie sesión en nuestro repositorio privado de artefactos, Agora, con sus credenciales de Deque.
  2. Desde el "Bienvenido, <your_email>" del menú desplegable, seleccione 'Editar perfil'.
  3. Haga clic en “Generar un token de identidad”.
  4. Se abrirá un cuadro de diálogo que mostrará la opción para copiar el token de referencia.
  5. Asigne un nombre distintivo al token de identidad y agréguelo en la descripción. El siguiente ejemplo utiliza AGORA_IDENTITY_TOKEN como el nombre
  6. Seleccione 'Siguiente'.
  7. En el siguiente cuadro de diálogo, por favor copie usted su token de identidad para usarlo en el siguiente script. Para una canalización automatizada, procure tener este token disponible en sus variables de entorno o secretos del proyecto para su plataforma.
note

El token de identidad solo es accesible desde el cuadro de diálogo y no podrá verlo de nuevo después de cerrarlo. Este token expirará 11 meses y 30 días después de su creación.

  1. Antes de ejecutar sus pruebas o compilación, recupere el reportero. Aquí tienes un script para empezar:
    # 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. Crea tu aplicación y ejecuta tus pruebas

  2. Una vez finalizadas las pruebas, ejecuta el reportero y especifique la ruta del archivo JSON de resultados.

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

Personalice su formato de salida (--format) con html, junit o csv.

Integración en un pipeline de iOS

Configura tus pruebas automatizadas

Actualice sus pruebas automatizadas para guardar los resultados localmente, que luego se pueden usar para generar el informe.

Pasos para generar el informe

  1. Inicie sesión en nuestro repositorio privado de artefactos, Agora, con sus credenciales de Deque.
  2. Desde el "Bienvenido, <your_email>"menú desplegable, seleccione "Editar perfil".
  3. Haga clic en “Generar un token de identidad”.
  4. Se abrirá un cuadro de diálogo que mostrará la opción para copiar el token de referencia.
  5. Asigne un nombre distintivo al token de identidad y agréguelo en la descripción. El ejemplo de abajo utiliza AGORA_IDENTITY_TOKEN como nombre.
  6. Seleccione 'Siguiente'.
  7. En el siguiente cuadro de diálogo, por favor copie usted su token de identidad para usarlo en el siguiente script. Para una canalización automatizada, procure tener este token disponible en sus variables de entorno o secretos del proyecto para su plataforma.
note

El token de identidad solo es accesible desde el cuadro de diálogo y no podrá verlo de nuevo después de cerrarlo. Este token expirará 11 meses y 30 días después de su creación.

  1. Antes de ejecutar sus pruebas o compilación, recupere el reportero. A continuación se muestra 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. Crea tu aplicación y ejecuta tus pruebas.

  2. Una vez finalizadas las pruebas, ejecuta el reportero y especifique la ruta del archivo JSON de resultados.

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

Personalice su formato de salida (--format) con html, junit o csv.

Is this page helpful?

Help us improve this page

Still need help?