Gerar Relatórios no 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

Com Axe DevTools Reporter, você pode agora gerar relatórios autônomos diretamente no seu pipeline de integração contínua / implantação contínua (CI/CD).

Siga os passos básicos abaixo para integrar o reporter ao seu pipeline Android ou iOS.

Integração em um Pipeline Android

Configure seus Testes Automatizados

  1. Atualize seus testes automatizados para salvar resultados localmente, que podem então ser usados para gerar o relatório.

  2. Adicione o script abaixo ao arquivo build.gradle do seu aplicativo, abaixo do bloco android, e certifique-se de que não esteja dentro de outra tarefa Gradle. Adicione o nome do pacote do seu aplicativo na variável packageName. Este script moverá os resultados gerados a partir da execução automatizada para o diretório de relatórios da pasta de build.

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
        }
    }
}

Passos para Gerar o Relatório

  1. Faça login no nosso repositório privado, Agora, com suas credenciais Deque.
  2. No menu suspenso "Bem-vindo, <seu_email>", selecione 'Editar Perfil'.
  3. Clique em 'Gerar um Token de Identidade'.
  4. Uma caixa de diálogo será aberta e mostrará a opção de copiar o Token de Referência.
  5. Crie um nome distinto para o Token de Identidade e adicione-o na descrição. O exemplo abaixo usa AGORA_IDENTITY_TOKEN como nome.
  6. Selecione 'Próximo'.
  7. Na próxima caixa de diálogo, por favor, copie seu Token de Identidade para uso no script abaixo. Para um pipeline automatizado, considere ter esse token disponível em suas variáveis de ambiente ou segredos de projeto para sua plataforma.
note

O Token de Identidade é acessível apenas dentro do diálogo e não será possível visualizá-lo novamente após fechar o diálogo. Este token expirará 11 meses e 30 dias após sua criação.

  1. Antes de executar seus testes ou build, busque o reporter. Aqui está um script para começar:
    # 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. Construa seu app e execute seus testes

  2. Depois que os testes terminarem, execute o repórter e especifique o caminho do arquivo dos arquivos JSON de resultados.

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

Personalize o formato de saída (--format) com html, junit ou csv.

Integração em um Pipeline iOS

Configure seus Testes Automatizados

Atualize seus testes automatizados para salvar resultados localmente, que podem então ser usados para gerar o relatório.

Passos para Gerar o Relatório

  1. Faça login no nosso repositório privado, Agora, com suas credenciais Deque.
  2. No menu suspenso "Bem-vindo, <seu_email>", selecione "Editar Perfil".
  3. Clique em 'Gerar um Token de Identidade'.
  4. Uma caixa de diálogo será aberta e mostrará a opção de copiar o Token de Referência.
  5. Crie um nome distinto para o Token de Identidade e adicione-o na descrição. O exemplo abaixo usa AGORA_IDENTITY_TOKEN como nome.
  6. Selecione 'Próximo'.
  7. Na próxima caixa de diálogo, por favor, copie seu Token de Identidade para uso no script abaixo. Para um pipeline automatizado, considere ter esse token disponível em suas variáveis de ambiente ou segredos de projeto para sua plataforma.
note

O Token de Identidade é acessível apenas dentro do diálogo e não será possível visualizá-lo novamente após fechar o diálogo. Este token expirará 11 meses e 30 dias após sua criação.

  1. Antes de executar seus testes ou build, obtenha o repórter. Aqui está um script útil para começar:
    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. Compile seu aplicativo e execute seus testes.

  2. Depois que os testes terminarem, execute o repórter e especifique o caminho do arquivo dos arquivos JSON de resultados.

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

Personalize o formato de saída (--format) com html, junit ou csv.

Is this page helpful?

Help us improve this page

Still need help?