Codeabdeckungsberichte

CodeBuild ermöglicht es Ihnen, Code-Coverage-Berichte für Ihre Tests zu erstellen. Die folgenden Code-Coverageberichte werden bereitgestellt:

Line-Abdeckung

Die Leitungsabdeckung misst, wie viele Aussagen Ihre Tests abdecken. Eine Aussage ist eine einzige Anweisung, die keine Kommentare oder Bedingungen enthält.

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

Verzweigen Abdeckung

Die Branch Coverage misst, wie viele Zweige Ihre Tests aus jedem möglichen Zweig einer Kontrollstruktur abdecken, z.ifodercasestatement.

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

Die folgenden Dateiformate für Codeabdeckungsberichte werden unterstützt:

• JACOCOXML

• SimpleCov JSON¹

• Clover XML

• Cobertura XML

^{¹ CodeBuild akzeptiert JSON-Codeabdeckung Berichte, die vonsimplecov, nichtsimplecov-jsonaus.}

Erstellen Sie einen Code-Coverage-Bericht

Um einen Codeabdeckungsbericht zu erstellen, führen Sie ein Build-Projekt aus, das mit mindestens einer Berichtsgruppe für Codeabdeckungsberichte in der buildspec-Datei konfiguriert ist. CodeBuild interpretiert die Ergebnisse der Codeabdeckung und stellt einen Code-Coverage-Bericht für den Lauf bereit. Für jeden nachfolgenden Build, der dieselbe buildspec-Datei verwendet, wird ein neuer Testbericht generiert.

So erstellen Sie einen Testbericht:

1. Erstellen Sie ein Build-Projekt. Weitere Informationen finden Sie unter Erstellen eines Build-Projekts in AWS CodeBuild.

2. Konfigurieren Sie die buildspec-Datei Ihres Projekts mit Testberichtinformationen:

   1. Hinzufügen einerreports:-Abschnitt und geben Sie den Namen für die Berichtsgruppe an. CodeBuild erstellt für Sie eine Berichtsgruppe mit Ihrem Projektnamen und dem Namen, den Sie im Format angegeben habenproject-name-report-group-name-in-buildspecaus. Wenn Sie bereits über eine Berichtsgruppe verfügen, die Sie verwenden möchten, geben Sie deren ARN an. Wenn Sie den Namen anstelle des ARN verwenden, erstellt CodeBuild eine neue Berichtsgruppe. Weitere Informationen finden Sie unter Reports syntax in the buildspec file.

   2. Geben Sie unter der Berichtsgruppe den Speicherort der Dateien an, die die Ergebnisse der Codeabdeckung enthalten. Wenn Sie mehr als eine Berichtsgruppe verwenden, geben Sie die Speicherorte der Ergebnisdatei für jede Berichtsgruppe an. Jedes Mal, wenn Ihr Build-Projekt ausgeführt wird, wird ein neuer Codeabdeckungsbericht erstellt. Weitere Informationen finden Sie unter Angeben der Testdateien.

      Dies ist ein Beispiel, das einen Code-Coverage-Bericht für eine JaCoCo XML-Ergebnisdatei generiert, die sich im Test-results/jacoco-coverage-report.xmlaus.

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

   3. In dercommands-Abschnitt imbuildoderpost_build, geben Sie die Befehle an, die die Code-Coverage-Analyse ausführen. Weitere Informationen finden Sie unter Angeben der Testbefehle .

3. Führen Sie einen Build des Build-Projekts aus. Weitere Informationen finden Sie unter Ausführen eines Build in AWS CodeBuild.

4. Wenn der Build abgeschlossen ist, wählen Sie den neuen Build Run unter Build history (Build-Verlauf) auf Ihrer Projektseite aus. Klicken Sie aufBerichteum den Bericht zur Codeabdeckung anzuzeigen. Weitere Informationen finden Sie unter Anzeigen von Testberichten für einen Build.