Report di copertura del codice

CodeBuild ti consente di generare report sulla copertura del codice per i tuoi test. Vengono forniti i seguenti report sulla copertura del codice:

copertura delle istanze

La copertura della linea misura il numero di dichiarazioni coperte dai tuoi test. Una dichiarazione è un'unica istruzione, che non include commenti o condizionali.

line coverage = (total lines covered)/(total number of lines)

copertura delle istanze

La copertura delle filiali misura il numero di rami che i tuoi test coprono da ogni possibile ramo di una struttura di controllo, come ad esempioifocasedichiarazione.

branch coverage = (total branches covered)/(total number of branches)

Sono supportati i seguenti formati di file di report di copertura del codice:

• XML di JaCoCo

• JSON SimpleCov ¹

• XML di Clover

• XML di Cobertura

^{¹ CodeBuild accetta i report di copertura del codice JSON generati dasimplecov, nonsimplecov-json.}

Creare un report sulla copertura del codice

Per creare un report di copertura del codice, è possibile eseguire un progetto di compilazione configurato con almeno un gruppo di report di copertura del codice nel relativo file buildspec. CodeBuild interpreterà i risultati della copertura del codice e fornirà un report sulla copertura del codice per l'esecuzione. Per ogni compilazione successiva che dovesse utilizzare lo stesso file buildspec, verrà generato un nuovo report di test.

Come creare un report di test

1. Creare un progetto di compilazione. Per informazioni, consultare Creazione di un progetto di compilazione in AWS CodeBuild.

2. Configurare il file buildspec del progetto con le informazioni relative al report di test:

   1. Aggiungi unreports:sezione e specificare il nome per il gruppo di report. CodeBuild crea un gruppo di report utilizzando il nome del progetto e il nome specificato nel formatoproject-name-report-group-name-in-buildspec. Se si dispone già di un gruppo di report da utilizzare, basta specificarne l'ARN. Se si specifica il nome anziché l'ARN, CodeBuild crea un nuovo gruppo di report. Per ulteriori informazioni, consultare Reports syntax in the buildspec file.

   2. Nel gruppo di report, specificare la posizione dei file contenenti i risultati di copertura del codice. Se si utilizzano più gruppi di report, specificare le posizioni dei file di risultati per ciascun gruppo di report. A ogni esecuzione del progetto di compilazione viene creato un nuovo report di copertura del codice. Per ulteriori informazioni, consultare Specifica dei file di test.

      Questo è un esempio che genera un report di copertura del codice per un file di risultati XML JaCoCo situato nel test-results/jacoco-coverage-report.xml.

      reports:
        jacoco-report:
          files:
            - 'test-results/jacoco-coverage-report.xml'
          file-format: 'JACOCOXML'
      

   3. NellacommandsSezione dellabuildopost_buildsequenza, specificare i comandi che eseguono l'analisi della copertura del codice. Per ulteriori informazioni, consultare Specifica dei comandi di test .

3. Eseguire una compilazione del progetto. Per ulteriori informazioni, consultare Esecuzione di una compilazione in AWS CodeBuild.

4. Al termine, selezionare la nuova esecuzione di compilazione da Build history (Cronologia delle compilazioni) alla pagina del progetto. ScegliereReportper visualizzare il rapporto sulla copertura del codice. Per ulteriori informazioni, consultare Visualizzazione dei report di test in una compilazione.