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 los 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 cobertura de línea, método y clase. 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.

La especificación de una ruta de acceso a los archivos de origen es necesaria 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 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 las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

Nota

Consulte Nueva versión de la tarea Publicar resultados de cobertura de código en el blog de Azure DevOps para obtener información sobre las nuevas características de la tarea Publicar resultados de cobertura de código y migrar de V1 a V2.

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.

Las tareas como Visual Studio Test, .NET Core, Ant, Maven, Gulp y 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 Publicar resultados de cobertura de código aparte 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 dotnet 7.0.x como requisito previo en la canalización. Use la tarea de dotnet core antes de la tarea Publicar cobertura de código v2.

Requisitos previos

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 con los valores siguientes.

   

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 Personalización de JavaScript en la sección Ecosistemas de estos temas, que también incluye ejemplos para otros lenguajes.

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

Docker

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 resultados con un archivode Docker para Docker.

Vista de resultados

Para ver los resultados de la cobertura de código en la canalización, consulte Revisión de los resultados de la 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 archivoindex.html principal. 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
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	2.144.0 o superior
Categoría de la tarea:	Prueba

Consulte también

• Publicar resultados de pruebas