O CodeBuild permite gerar relatórios de cobertura de código para os testes. Os seguintes relatórios de cobertura de código são fornecidos:
- Cobertura de linha
-
A cobertura de linha mede quantas declarações os testes abrangem. Declaração é uma instrução única, que não inclui comentários nem condicionais.
line coverage = (total lines covered)/(total number of lines)
- Cobertura de ramificação
-
A cobertura de ramificação mede quantas ramificações os testes abrangem de todas as ramificações possíveis de uma estrutura de controle, como uma declaração
if
oucase
.branch coverage = (total branches covered)/(total number of branches)
Os seguintes formatos de arquivo de relatório de cobertura de código são compatíveis:
-
JaCoCo XML
-
SimpleCov JSON¹
-
Clover XML
-
Cobertura XML
-
INFORMAÇÕES SOBRE O LCOV
¹ O CodeBuild aceita relatórios de cobertura de código JSON gerados pelo simplecov
Criar um relatório de cobertura de código
Para criar um relatório de cobertura de código, execute um projeto de compilação configurado com, pelo menos, um grupo de relatórios de cobertura de código no arquivo buildspec. O CodeBuild interpretará os resultados da cobertura de código e fornecerá um relatório dessa cobertura para a execução. Um novo relatório de teste é gerado para cada compilação subsequente que usa o mesmo arquivo buildspec.
Para criar um relatório de teste
-
Crie um projeto de compilação. Para obter mais informações, consulte Criar um projeto de compilação no AWS CodeBuild.
-
Configure o arquivo buildspec do projeto com informações do relatório de teste:
-
Adicione uma seção
reports:
e especifique o nome do grupo de relatórios. O CodeBuild cria um grupo de relatórios usando o nome do projeto e o nome especificado no formatoproject-name
-report-group-name-in-buildspec
. Se você já tiver um grupo de relatórios que deseja usar, especifique seu ARN. Se você usar o nome em vez do ARN, o CodeBuild criará um grupo de relatórios. Para obter mais informações, consulte Reports syntax in the buildspec file. -
No grupo de relatórios, especifique o local dos arquivos que contêm os resultados da cobertura de código. Se você usar mais de um grupo de relatórios, especifique os locais do arquivo de resultados para cada grupo de relatórios. Um novo relatório de cobertura de código é criado sempre que o projeto de compilação é executado. Para obter mais informações, consulte Especificar arquivos de teste.
Trata-se de um exemplo que gera um relatório de cobertura de código para um arquivo de resultados JaCoCo XML localizado em test-
results/jacoco-coverage-report.xml
.reports: jacoco-report: files: - 'test-results/jacoco-coverage-report.xml' file-format: 'JACOCOXML'
-
Na seção
commands
da sequênciabuild
oupost_build
, especifique os comandos que executam a análise de cobertura de código. Para obter mais informações, consulte Especificar comandos de teste .
-
-
Execute uma compilação do projeto de compilação. Para obter mais informações, consulte Executar compilações do AWS CodeBuild manualmente.
-
Quando a compilação estiver concluída, escolha a nova execução de compilação em Histórico de compilação na página do projeto. Escolha Relatórios para ver o relatório de cobertura de código. Para obter mais informações, consulte Visualizar relatórios de teste para uma compilação.