Informes de cobertura de código - AWS CodeBuild

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Informes de cobertura de código

CodeBuild 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¹

  • Clover XML

  • Cobertura XML

¹ CodeBuild acepta informes de cobertura JSON generados por simplecov, no simplecov-json.

Crear un informe de cobertura de código

Para crear un informe de cobertura de código, se ejecuta un proyecto de compilación que se configura con al menos un grupo de informes de cobertura en el archivo de especificación de la compilación. CodeBuild interpretará los resultados de la cobertura del código y proporcionará un informe de cobertura del 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 de especificación de la compilación del proyecto con información de informe de pruebas:

    1. Añada una sección reports: y especifique el nombre del grupo de informes. CodeBuild crea un grupo de informes utilizando el nombre del proyecto y el nombre especificado en el formato project-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 del 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 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 con un archivo de resultados JaCoCo XML situado 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 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. 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.