Création de rapports sur la couverture du code

CodeBuild vous permet de générer des rapports de couverture de code pour vos tests. Les rapports de couverture des codes suivants sont fournis :

Couverture de la ligne

La couverture linéaire mesure le nombre de déclarations couvertes par vos tests. Une instruction est une instruction unique, sans commentaires ni conditions.

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

Couverture des succursales

La couverture des branches mesure le nombre de branches couvertes par vos tests parmi toutes les branches possibles d'une structure de contrôle, comme une case instruction if or.

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

Les formats de fichier de rapport de couverture de code suivants sont pris en charge :

• JaCoCo XML

• SimpleCov JSON¹

• Trèfle XML

• Cobertura XML

• LCOV INFO

^{¹ CodeBuild accepte les rapports de couverture de JSON code générés par simplecov, et non par simplecov-json.}

Création d'un rapport sur la couverture du code

Pour créer un rapport de couverture de code, vous exécutez un projet de génération configuré avec au moins un groupe de rapports de couverture de code dans son fichier buildspec. CodeBuild interprétera les résultats de couverture du code et fournira un rapport de couverture du code pour l'exécution. Un nouveau rapport de test est généré pour chaque génération ultérieure qui utilise le même fichier buildspec.

Pour créer un rapport de test

1. Créez un projet de génération. Pour plus d’informations, veuillez consulter Créez un projet de construction dans AWS CodeBuild.

2. Configurez le fichier buildspec de votre projet avec les informations du rapport de test :

   1. Ajoutez une reports: section et spécifiez le nom de votre groupe de rapports. CodeBuild crée un groupe de rapports pour vous en utilisant le nom de votre projet et le nom que vous avez spécifié au format project-name -report-group-name-in-buildspec. Si vous avez déjà un groupe de rapports que vous souhaitez utiliser, spécifiez-leARN. Si vous utilisez le nom au lieu deARN, CodeBuild crée un nouveau groupe de rapports. Pour de plus amples informations, veuillez consulter Reports syntax in the buildspec file.

   2. Dans le groupe de rapports, spécifiez l'emplacement des fichiers contenant les résultats de couverture du code. Si vous utilisez plusieurs groupes de rapports, spécifiez l'emplacement des fichiers de résultats pour chaque groupe de rapports. Un nouveau rapport de couverture du code est créé chaque fois que votre projet de construction s'exécute. Pour de plus amples informations, veuillez consulter Spécification des fichiers de test.

      Il s'agit d'un exemple qui génère un rapport de couverture de code pour un fichier de JaCoCo XML résultats situé dans test-results/jacoco-coverage-report.xml.

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

   3. Dans la commands section de la post_build séquence build or, spécifiez les commandes qui exécutent l'analyse de couverture du code. Pour de plus amples informations, veuillez consulter Spécification des commandes de test .

3. Exécutez une version du projet de génération. Pour de plus amples informations, veuillez consulter Exécuter AWS CodeBuild les builds manuellement.

4. Une fois la génération terminée, choisissez la nouvelle version dans Historique de génération sur la page de votre projet. Choisissez Rapports pour afficher le rapport sur la couverture du code. Pour de plus amples informations, veuillez consulter Affichage des rapports de test d'une génération.