Informes de cobertura de código

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

Cobertura de línea

La cobertura de línea mide el número de declaraciones cubiertas por las pruebas. Una declaración es una sola instrucción, in contar comentarios ni condicionales.

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

Cobertura de ramificaciones

La cobertura de ramificaciones mide cuántas ramificaciones cubren las pruebas de cada ramificación posible de una estructura de control, como una declaración if o case.

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

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

• JaCoCo XML

• SimpleCov JSON¹

• Trébol XML

• Cobertura XML

• LCOV INFO

^{¹ CodeBuild acepta informes de cobertura JSON de código generados por simplecov, no por simplecov-json.}

Crear un informe de cobertura de código

Para crear un informe de cobertura de código, ejecuta un proyecto de compilación que esté configurado con al menos un grupo de informes de cobertura de código en su archivo buildspec. CodeBuild interpretará los resultados de la cobertura de 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 más información, consulte Creación de un proyecto de compilación en AWS CodeBuild.

2. Configure el archivo de especificación de la compilación del proyecto con información de informe de pruebas:

   1. Agregue una reports: sección y especifique el nombre del grupo de informes. CodeBuild crea un grupo de informes para usted con el nombre de su proyecto y el nombre que especificó en el formato project-name -report-group-name-in-buildspec. Si ya tiene un grupo de informes que desee usar, especifique el suyoARN. Si utiliza el nombre en lugar delARN, 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 la cobertura de código. Si utiliza más de un grupo de informes, especifique las ubicaciones de los archivos de resultados para cada uno de ellos. Cada vez que se ejecuta el proyecto de compilación, se crea un nuevo informe de cobertura de código. 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 JaCoCo XML resultados ubicado en test-results/jacoco-coverage-report.xml.

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

   3. En la sección commands de la secuencia build o post_build, especifique los comandos que ejecutan el análisis de cobertura del 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 Ejecuta una compilación 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. Seleccione Informes para ver el informe de cobertura de código. Para obtener más información, consulte Consultar los informes de pruebas de una compilación.