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

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

Sintaxe

# 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. Necessário.

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 - Falhar 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 produzir resultados a serem publicados.

Opções de controle de tarefa

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

Variáveis de saída

Nenhum.

Observações

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 pela 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 de Teste do Visual Studio, do .NET Core, Ant, Maven, Gulpe 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 de Resultados de Cobertura de Código de Publicação 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 os 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 outros idiomas.

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

Estivador

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 no Compilar, testar e publicar resultados com um arquivo do Docker seção para Docker.

Exibir resultados

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

Problemas conhecidos

A tarefa v2 de resultados de cobertura de código de publicação 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 que são vinculados do arquivo de index.html principal. Se a guia de cobertura de código não mostrar o relatório de cobertura de código, verifique se o arquivo xml de cobertura de código de entrada está no formato correto e se tem os detalhes válidos.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico
Execuções em	Agente
de demandas	Nenhum
recursos	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando	Qualquer
variáveis settable	Qualquer
Versão do agente	2.144.0 ou superior
Categoria de tarefa	Teste

Consulte também

• publicar resultados do teste