コードカバレッジレポートを作成する

CodeBuild では、テストのコードカバレッジレポートを生成できます。次のコードカバレッジレポートが用意されています。

ラインカバレッジ

ラインカバレッジは、テストがカバーするステートメントの数を測定します。ステートメントは、コメントや条件を含まない、単一の命令です。

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

ブランチカバレッジ

ブランチカバレッジは、コントロール構造のすべてのブランチ内のテスト可能なブランチの数を測定します (「if」または「case」ステートメントなど)。

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

以下のコードカバレッジレポートファイル形式がサポートされています。

• JaCoCo XML

• SimpleCov JSON1

• クローバー XML

• コベルトゥラ XML

• LCOV INFO

^{1 simplecov-json ではなく simplecov によって生成されたJSONコードカバレッジレポート CodeBuild を受け入れます。 https://github.com/vicentllongo/simplecov-json}

コードカバレッジレポートの作成

コードカバレッジレポートを作成するには、buildspec ファイルに少なくとも 1 つのコードカバレッジレポートグループで設定されたビルドプロジェクトを実行します。 CodeBuild はコードカバレッジ結果を解釈し、実行のコードカバレッジレポートを提供します。同じ buildspec ファイルを使用する後続のビルドごとに、新しいテストレポートが生成されます。

テストレポートを作成するには

1. ビルドプロジェクトを作成します。詳細については、でビルドプロジェクトを作成する AWS CodeBuild を参照してください。

2. テストレポート情報を使用してプロジェクトの buildspec ファイルを設定します。

   1. reports: セクションを追加し、レポートグループの名前を指定します。 は、プロジェクト名と project-name- 形式で指定した名前を使用してレポートグループ CodeBuild を作成しますreport-group-name-in-buildspec。使用するレポートグループが既にある場合は、その を指定しますARN。の代わりに 名を使用するとARN、 は新しいレポートグループ CodeBuild を作成します。詳細については、「Reports syntax in the buildspec file」を参照してください。

   2. レポートグループで、コードカバレッジの結果を保存するファイルの場所を指定します。複数のレポートグループを使用する場合は、各レポートグループに対して結果ファイルの場所を指定します。ビルドプロジェクトを実行するたびに、新しいコードカバレッジが作成されます。詳細については、「テストファイルの指定」を参照してください。

      これは test- にあるXML結果ファイルのコードカバレッジレポート JaCoCoを生成する例ですresults/jacoco-coverage-report.xml。

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

   3. 「build」または「post_build」シーケンスの「commands」セクションで、コードカバレッジ分析を実行するコマンドを指定します。詳細については、「 テストコマンドの指定 」を参照してください。

3. ビルドプロジェクトのビルドを実行します。詳細については、「AWS CodeBuild ビルドを手動で実行する」を参照してください。

4. ビルドが完了したら、プロジェクトページの [Build history (ビルド 履歴)] から新しいビルド実行を選択します。レポートを選択して、コードカバレッジレポートを表示します。詳細については、「ビルドのテストレポートの表示」を参照してください。