PublishCodeCoverageResults@2 – Publicar a tarefa de resultados da cobertura de código v2

Use essa tarefa para obter resultados de cobertura de código de um build.

Syntax

# 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 - Caminho para arquivos de resumo
string. Obrigatórios.

Especifica o caminho do arquivo de resumo que contém estatísticas de cobertura de código, como cobertura de linha, método e classe. Vários arquivos de resumo são mesclados em um único relatório. O valor pode conter padrões de minimatch. Por exemplo: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml. Mais informações sobre padrões de minimatch.

pathToSources - Caminho para arquivos de origem
string.

Especificar um caminho para arquivos de origem é necessário quando os relatórios XML de cobertura não contêm um caminho absoluto para arquivos de origem. Por exemplo, os relatórios JaCoCo não usam caminhos absolutos, portanto, ao publicar a cobertura JaCoCo para aplicativos Java, o padrão é semelhante a $(System.DefaultWorkingDirectory)/MyApp/src/main/java/. Essa entrada deve apontar para um caminho absoluto para arquivos de origem no host. Por exemplo, $(System.DefaultWorkingDirectory)/MyApp/.

Essa entrada poderá ser usada se os testes forem executados em um contêiner do Docker.

failIfCoverageEmpty - Falha se os resultados da cobertura de código estiverem ausentes
boolean. Valor padrão: false.

Falha na tarefa se a cobertura de código não produziu nenhum resultado para publicar.

Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Observação

Confira Nova versão da tarefa Publicar Resultados da Cobertura de Código no blog do Azure DevOps para obter informações sobre os novos recursos na V2 da tarefa Publicar Resultados da Cobertura de Código e migrar da V1 para a V2.

Use essa tarefa em um pipeline de build para publicar os resultados de cobertura de código produzidos ao executar testes no Azure Pipelines ou TFS e depois de gerar os arquivos xml de cobertura para obter a guia de cobertura de código e os detalhes do relatório de cobertura no pipeline. A tarefa dá suporte a formatos xml gerados por cobertura de código. Essa tarefa gera um arquivo cjson que contém os detalhes de cobertura de código. Ele também produzirá um relatório HTML de cobertura de código sob os artefatos de build.

Essa tarefa só tem suporte em pipelines de build, não em pipelines de lançamento.

Tarefas como Visual Studio Test, .NET Core, Ant, Maven, Gulp e Grunt também fornecem a opção de publicar dados de cobertura de código no pipeline. Se você estiver usando essas tarefas, não precisará de uma tarefa Publicar Resultados de Cobertura de Código separada no pipeline.

Pré-requisito – para usar a tarefa Publicar Resultados de Cobertura de Código v2 no pipeline, use a tarefa dotnet 7.0.x como pré-requisito no pipeline. Use a tarefa dotnet core antes da tarefa Publicar Cobertura de Código v2.

Pré-requisitos

Para configurar os pré-requisitos usando um pipeline 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 os pré-requisitos usando o designer:

1. Configure a tarefa Publicar Resultados de Cobertura de Código versão 2 usando as configurações a seguir.

   

2. Depois que o build for concluído e a tarefa Publicar Resultados de Cobertura de Código v2 for bem-sucedida, selecione a guia Cobertura de Código no resumo da execução do pipeline para exibir os resultados da cobertura de código.

   

Resultados de cobertura de código para JavaScript com Istambul usando YAML

Para publicar resultados de cobertura de código para JavaScript com Istambul usando YAML, consulte Personalizar JavaScript na seção Ecossistemas desses tópicos, que também inclui exemplos para outras linguagens.

Veja um exemplo de publicação de cobertura de código usando Cobertura.

Docker

Para aplicativos que usam o Docker, o build e os testes podem ser executados dentro do contêiner e gerar resultados de cobertura de código dentro do contêiner. Para publicar os resultados no pipeline, os artefatos resultantes devem ser disponibilizados para a tarefa Publicar Resultados de Cobertura de Código . Para referência, você pode ver um exemplo semelhante para publicar resultados de teste na seção Compilar, testar e publicar resultados com um arquivo do Docker para Docker.

Exibir os resultados

Para exibir os resultados da cobertura de código no pipeline, confira Examinar os resultados da cobertura de código.

Problemas conhecidos

A tarefa publicar resultados de cobertura de código v2 gera um arquivo cjson e publica o relatório de cobertura de código na guia cobertura de código. Ele também produz um artefato de build que é um conjunto de arquivos HTML vinculados do arquivo mainindex.html. Se a guia cobertura de código não mostrar o relatório de cobertura de código, marcar se o arquivo xml de cobertura de código de entrada está no formato correto e tem os detalhes válidos.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico
Executa em	Agente
Demandas	Nenhum
Funcionalidades	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	2.144.0 ou superior
Categoria da tarefa	Teste

Confira também

• Publicar resultados do teste