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

Use esta tarefa para obter resultados de cobertura de código de uma compilação.

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.

Insumos

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 minicorrespondência. Por exemplo: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml. Mais informações sobre padrões de minimatch.

pathToSources - caminho para arquivos de origem
string.

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

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

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

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

Opções de controlo de tarefas

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

Variáveis de saída

Nenhuma.

Comentários

Use esta tarefa em um pipeline de compilação 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 suporta todos os tipos de formatos de cobertura, tais como: .coverage, .covx, .covb, .cjson, .xml, .lcov, pycov, etc. Ele gera um arquivo cjson que contém os detalhes de cobertura do código. Ele também produzirá um relatório HTML de cobertura de código sob os artefatos de compilação.

Ao contrário da tarefa PublishCodeCoverageResults@1, a v2 pode gerar a a cobertura de de comparação para vários idiomas no mesmo pipeline. Além disso, a guia de cobertura de código da tarefa PublishCodeCoverageResultsV2 é a mesma da tarefa PublishCodeCoverageV1.

Essa tarefa só é suportada em pipelines de compilação, não em pipelines de liberação.

Tarefas como Visual Studio Test, .NET Core, Ant, Maven, Gulpe Grunt também oferecem 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 separada Publicar resultados de cobertura de código no pipeline.

Pré-requisito- Para usar a tarefa Publicar resultados de cobertura de código v2 no pipeline, use a tarefa Usar o .NET Core como pré-requisito no pipeline. Use a tarefa principal dotnet antes da tarefa Publicar Cobertura de Código v2.

Pré-requisitos

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

   

2. Depois que a compilação for concluída e a tarefa Publicar resultados de cobertura de código v2 for bem-sucedida, selecione a guia de cobertura de código de no resumo de 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 destes tópicos, que também inclui exemplos para outros idiomas.

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

Docker

Para aplicativos que usam o Docker, a compilação 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.

Ver resultados

Para exibir os resultados da cobertura de código no pipeline, consulte Revisar 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 de cobertura de código. Ele também produz um artefato de construção que é um conjunto de arquivos HTML que são vinculados a partir do arquivo 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 tem os detalhes válidos.

Requerimentos

Exigência	Descrição
Tipos de pipeline	YAML, construção clássica
Funciona em	Agente
Exigências	Nenhum
Capacidades	Esta tarefa não satisfaz quaisquer exigências 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 de tarefa	Teste

Ver também

• Publicar resultados de testes