As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criar relatórios de cobertura de código
<a name="code-coverage-report"></a>

CodeBuild permite gerar relatórios de cobertura de código para seus 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` ou `case`.  
`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

[¹ CodeBuild aceita relatórios de cobertura de código JSON gerados pelo [simplecov, não pelo simplecov-json](https://github.com/simplecov-ruby/simplecov).](https://github.com/vicentllongo/simplecov-json)

## Criar um relatório de cobertura de código
<a name="code-coverage-report-create"></a>

Para criar um relatório de cobertura de código, você executa um projeto de compilação configurado com pelo menos um grupo de relatórios de cobertura de código em seu arquivo buildspec. CodeBuild interpretará os resultados da cobertura do código e fornecerá um relatório da cobertura do código 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**

1. Crie um projeto de compilação. Para mais informações, consulte [Criar um projeto de compilação no AWS CodeBuild](create-project.md).

1. Configure o arquivo buildspec do projeto com informações do relatório de teste:

   1. Adicione uma `reports:` seção e especifique o nome do seu grupo de relatórios. CodeBuild cria um grupo de relatórios para você usando o nome do seu projeto e o nome que você especificou no formato `project-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, CodeBuild cria um novo grupo de relatórios. Para obter mais informações, consulte [Reports syntax in the buildspec file](build-spec-ref.md#reports-buildspec-file). 

   1. 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](report-group-test-cases.md).

      Este é 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'
      ```

   1. Na seção `commands` da sequência `build` ou `post_build`, especifique os comandos que executam a análise de cobertura de código. Para obter mais informações, consulte [Especificar comandos de teste](report-group-test-case-commands.md). 

1. Execute uma compilação do projeto de compilação. Para obter mais informações, consulte [Execute AWS CodeBuild compilações manualmente](run-build.md).

1. 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](test-view-project-reports.md).