Informes de cobertura de códigos

CodeBuild le permite generar informes de cobertura de código para sus pruebas. Se proporcionan los siguientes informes de cobertura de código:

coverage de líneas

La cobertura de línea mide cuántas declaraciones cubren sus exámenes. Una declaración es una única instrucción, sin incluir comentarios ni condicionales.

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

coverage de sucursales

La cobertura de sucursal mide cuántas sucursales cubren sus pruebas de cada rama posible de una estructura de control, como unifocasestatement.

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

Se admiten los siguientes formatos de archivo de informe de cobertura de código:

• XML de JaCoCo

• SimpleCov JSON¹

• XML de trébol

• Cobertura XML

^{¹ CodeBuild acepta informes de cobertura de código JSON generados porsimplecov, nosimplecov-json.}

Crear un informe de cobertura de código

Para crear un informe de cobertura de códigos, se ejecuta un proyecto de compilación que se configura con al menos un grupo de informes de cobertura de códigos en su archivo buildspec. CodeBuild interpretará los resultados de la cobertura del código y proporcionará un informe de cobertura de código para la ejecución. Se genera un nuevo informe de pruebas para cada compilación posterior que utilice el mismo archivo buildspec.

Para crear un informe de pruebas

1. Cree un proyecto de compilación. Para obtener información, consulte Creación de un proyecto de compilación en AWS CodeBuild.

2. Configure el archivo buildspec de su proyecto con información de informe de prueba:

   1. Adición de unreports:y especifique el nombre de su grupo de informes. CodeBuild crea un grupo de informes automáticamente utilizando el nombre de su proyecto y el nombre especificado en el formatoproject-name-report-group-name-in-buildspec. Si ya tiene un grupo de informes que desee utilizar, especifique su ARN. Si utiliza el nombre en lugar de el ARN, CodeBuild crea un nuevo grupo de informes. Para obtener más información, consulte Reports syntax in the buildspec file.

   2. En el grupo de informes, especifique la ubicación de los archivos que contienen los resultados de cobertura de código. Si utiliza más de un grupo de informes, especifique las ubicaciones de los archivos de resultados para cada grupo de informes. Cada vez que se ejecuta el proyecto de compilación, se crea un nuevo informe de cobertura de códigos. Para obtener más información, consulte Especificar archivos de prueba.

      Este es un ejemplo que genera un informe de cobertura de código para un archivo de resultados XML de JaCoCo ubicado en la prueba-results/jacoco-coverage-report.xml.

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

   3. En el navegadorcommandsSección sobre de labuildopost_buildsecuencia, especifique los comandos que ejecutan el análisis de cobertura de código. Para obtener más información, consulte Especificar comandos de prueba .

3. Ejecute una compilación del proyecto de compilación. Para obtener más información, consulte Ejecutar una compilación en AWS CodeBuild.

4. Cuando la compilación se haya completado, elija la nueva ejecución de la compilación en Build history (Historial de compilación) en la página del proyecto. ElegirInformes depara ver el informe de cobertura de código. Para obtener más información, consulte Consultar los informes de pruebas de una compilación.