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 formatos xml gerados pela cobertura de código. Esta tarefa gera um arquivo cjson que contém os detalhes da cobertura do código. Ele também produzirá um relatório HTML de cobertura de código sob os artefatos de compilação.
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 dotnet 7.0.x como pré-requisito no pipeline. Use a tarefa principal dotnet 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:
Configure a tarefa Publicar Resultados de Cobertura de Código versão 2 usando as seguintes configurações.
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
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 |