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
ocase
.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
-
INFORMACIÓN DE LCOV
¹ CodeBuild acepta informes de cobertura JSON generados por simplecov
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
-
Cree un proyecto de compilación. Para obtener más información, consulte Creación de un proyecto de compilación en AWS CodeBuild.
-
Configure el archivo de especificación de la compilación del proyecto con información de informe de pruebas:
-
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 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 del ARN, CodeBuild crea un nuevo grupo de informes. Para obtener más información, consulte Reports syntax in the buildspec file. -
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'
-
En la sección
commands
de la secuenciabuild
opost_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 .
-
-
Ejecute una compilación del proyecto de compilación. Para obtener más información, consulte Ejecución de compilaciones de AWS CodeBuild de forma manual.
-
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.