View a markdown version of this page

Berichte zur Codeabdeckung erstellen - AWS CodeBuild
Erstellen Sie einen Bericht zur Codeabdeckung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Berichte zur Codeabdeckung erstellen

CodeBuild ermöglicht es Ihnen, Berichte über die Codeabdeckung für Ihre Tests zu erstellen. Die folgenden Code-Abdeckungsberichte werden bereitgestellt:

Zeilenabdeckung

Die Zeilenabdeckung misst, wie viele Anweisungen Ihre Tests umfassen. Eine Anweisung ist eine einzelne Anweisung ohne Kommentare oder Bedingungen.

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

Verzweigungsabdeckung

Die Verzweigungsabdeckung misst, wie viele Verzweigungen von allen möglichen Verzweigungen einer Kontrollstruktur Ihre Tests umfassen, z. B. einer if- oder case-Anweisung.

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

Für Code-Abdeckungsberichte werden die folgenden Dateiformate unterstützt:

  • JaCoCo XML

  • SimpleCov JSON¹

  • Clover XML

  • Cobertura XML

  • LCOV INFO

¹ CodeBuild akzeptiert Berichte zur JSON-Codeabdeckung, die von simplecov generiert wurden, nicht von simplecov-json.

Erstellen Sie einen Bericht zur Codeabdeckung

Um einen Bericht über die Codeabdeckung zu erstellen, führen Sie ein Buildprojekt aus, das mit mindestens einer Berichtsgruppe zur Codeabdeckung in der Buildspec-Datei konfiguriert ist. CodeBuild interpretiert die Ergebnisse der Codeabdeckung und erstellt einen Bericht über die Codeabdeckung für den Testlauf. 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 Sie ein Build-Projekt in AWS CodeBuild.

  2. Konfigurieren Sie die Buildspec-Datei Ihres Projekts mit Testberichtsinformationen:

    1. Fügen Sie einen reports: Abschnitt hinzu und geben Sie den Namen für Ihre Berichtsgruppe an. CodeBuild erstellt eine Berichtsgruppe für Sie unter Verwendung Ihres Projektnamens und des Namens, den Sie im Format project-name - angegeben habenreport-group-name-in-buildspec. 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, CodeBuild wird eine neue Berichtsgruppe erstellt. 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 Ergebnisdateien für jede Berichtsgruppe an. Bei jeder Ausführung Ihres Build-Projekts wird ein neuer Bericht zur Codeabdeckung erstellt. Weitere Informationen finden Sie unter Angeben der Testdateien.

      Dies ist ein Beispiel, das einen Bericht über die Codeabdeckung für eine JaCoCo XML-Ergebnisdatei generiert, die sich im Verzeichnis test- befindetresults/jacoco-coverage-report.xml.

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

    3. Geben Sie im commands Abschnitt der post_build Sequenz build oder die Befehle an, mit denen die Codeabdeckungsanalyse ausgeführt wird. Weitere Informationen finden Sie unter Angeben der Testbefehle.

  3. Führen Sie einen Build des Build-Projekts aus. Weitere Informationen finden Sie unter Manuelles Ausführen von AWS CodeBuild Builds.

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