PublishCodeCoverageResults@2: tarea Publicar resultados de cobertura de código v2

Use esta tarea para obtener los resultados de cobertura de código de una compilación.

Sintaxis

# Publish code coverage results v2
# Publish any of the code coverage results from a build.
- task: PublishCodeCoverageResults@2
  inputs:
    summaryFileLocation: # string. Required. Path to summary files. 
    #pathToSources: # string. Path to Source files. 
    #failIfCoverageEmpty: false # boolean. Fail if code coverage results are missing. Default: false.

Entradas

summaryFileLocation - Ruta de acceso a archivos de resumen
string. Obligatorio.

Especifica la ruta de acceso del archivo de resumen que contiene estadísticas de cobertura de código, como la línea, el método y la cobertura de clases. Varios archivos de resumen se combinan en un único informe. El valor puede contener patrones de minimatch. Por ejemplo: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml. Más información sobre los patrones de minimatch.

pathToSources - ruta de acceso a los archivos de origen
string.

Se requiere especificar una ruta de acceso a los archivos de origen cuando los informes XML de cobertura no contienen una ruta de acceso absoluta a los archivos de origen. Por ejemplo, los informes de JaCoCo no usan rutas de acceso absolutas, por lo que al publicar la cobertura de JaCoCo para aplicaciones Java, el patrón es similar a $(System.DefaultWorkingDirectory)/MyApp/src/main/java/. Esta entrada debe apuntar a una ruta de acceso absoluta a los archivos de origen en el host. Por ejemplo, $(System.DefaultWorkingDirectory)/MyApp/.

Esta entrada se puede usar si las pruebas se ejecutan en un contenedor de Docker.

failIfCoverageEmpty - Error si faltan resultados de cobertura de código
boolean. Valor predeterminado: false.

Se produce un error en la tarea si la cobertura de código no ha generado ningún resultado para publicar.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Use esta tarea en una canalización de compilación para publicar los resultados de cobertura de código generados al ejecutar pruebas en Azure Pipelines o TFS y después de generar los archivos xml de cobertura para obtener la pestaña cobertura de código y los detalles de informes de cobertura en la canalización. La tarea admite formatos xml generados por cobertura de código. Esta tarea genera un archivo cjson que contiene los detalles de cobertura de código. También generará un informe HTML de cobertura de código en los artefactos de compilación.

Esta tarea solo se admite en canalizaciones de compilación, no en canalizaciones de versión.

Tareas como de pruebas de Visual Studio, .NET Core, Ant, Maven, Gulpy Grunt también proporcionan la opción de publicar datos de cobertura de código en la canalización. Si usa estas tareas, no necesita una tarea De resultados de cobertura de código de publicación independiente en la canalización.

Requisito previo: para usar la tarea Publicar resultados de cobertura de código v2 en la canalización, use la tarea de dotnet 7.0.x como requisito previo en la canalización. Use la tarea dotnet core antes de la tarea Publicar cobertura de código v2.

Prerrequisitos

Para configurar los requisitos previos mediante una canalización de YAML:

# Dotnet core sdk task 7.0.x
- task: UseDotNet@2
  displayName: 'Use .NET Core sdk 7.0.x'
  inputs:
    version: 7.0.x

Para configurar los requisitos previos mediante el diseñador:

1. Configure la tarea Publicar resultados de cobertura de código versión 2 mediante la siguiente configuración.

   

2. Una vez completada la compilación y la tarea Publicar resultados de cobertura de código v2 se realiza correctamente, seleccione la pestaña Cobertura de código en el resumen de ejecución de la canalización para ver los resultados de la cobertura de código.

   

Resultados de cobertura de código para JavaScript con Estambul mediante YAML

Para publicar resultados de cobertura de código para JavaScript con Estambul mediante YAML, consulte Personalizar javaScript en la sección Ecosistemas de estos temas, que también incluye ejemplos para otros lenguajes.

Vea un ejemplo de publicación de cobertura de código mediante Cobertura.

Estibador

En el caso de las aplicaciones que usan Docker, la compilación y las pruebas se pueden ejecutar dentro del contenedor y generar resultados de cobertura de código dentro del contenedor. Para publicar los resultados en la canalización, los artefactos resultantes deben estar disponibles para la tarea Publicar resultados de cobertura de código. Como referencia, puede ver un ejemplo similar para publicar resultados de pruebas en la sección compilación, prueba y publicación de con un archivo de Docker sección para Docker.

Ver resultados

Para ver los resultados de la cobertura de código en la canalización, consulte Revisar los resultados de cobertura de código.

Problemas conocidos

La tarea Publicar resultados de cobertura de código v2 genera un archivo cjson y publica el informe de cobertura de código en la pestaña cobertura de código. También genera artefactos de compilación que es un conjunto de archivos HTML que están vinculados desde el archivo principal index.html. Si la pestaña cobertura de código no muestra el informe de cobertura de código, compruebe si el archivo xml de cobertura de código de entrada tiene el formato correcto y tiene los detalles válidos.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica
Se ejecuta en	Agente
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquier
variables settable	Cualquier
Versión del agente	2.144.0 o superior
Categoría de tarea	Prueba

Consulte también

• publicar resultados de pruebas