PublishCodeCoverageResults@2 – Publicera kodtäckningsresultat v2-uppgift

Använd den här uppgiften för att hämta kodtäckningsresultat från en version.

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.

Indata

summaryFileLocation - Sökväg till sammanfattningsfiler
string. Krävs.

Anger sökvägen till sammanfattningsfilen som innehåller kodtäckningsstatistik, till exempel rad-, metod- och klasstäckning. Flera sammanfattningsfiler sammanfogas i en enda rapport. Värdet kan innehålla minimatchningsmönster. Exempel: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml. Mer information om minimatchmönster.


pathToSources - Sökväg till källfiler
string.

Du måste ange en sökväg till källfiler när XML-rapporter för täckning inte innehåller en absolut sökväg till källfiler. JaCoCo-rapporter använder till exempel inte absoluta sökvägar, så när du publicerar JaCoCo-täckning för Java-appar liknar $(System.DefaultWorkingDirectory)/MyApp/src/main/java/mönstret . Dessa indata bör peka på en absolut sökväg till källfiler på värden. Till exempel $(System.DefaultWorkingDirectory)/MyApp/.

Dessa indata kan användas om tester körs i en Docker-container.


failIfCoverageEmpty - Misslyckas om kodtäckningsresultat saknas
boolean. Standardvärde: false.

Aktiviteten misslyckas om kodtäckningen inte gav några resultat att publicera.


Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Anteckning

Se Ny version av aktiviteten Publicera kodtäckningsresultatAzure DevOps-bloggen för information om de nya funktionerna i V2 för uppgiften Publicera kodtäckningsresultat och migrera från V1 till V2.

Använd den här uppgiften i en bygg-pipeline för att publicera kodtäckningsresultat som genereras när du kör tester till Azure Pipelines eller TFS och när du har genererat XML-filerna för täckning för att hämta fliken för kodtäckning och rapporteringsinformation om täckning i pipelinen. Uppgiften stöder kodtäckningsgenererade XML-format. Den här uppgiften genererar en cjson-fil som innehåller information om kodtäckningen. Den skapar också en HTML-rapport för kodtäckning under byggartefakterna.

Den här uppgiften stöds bara i bygg-pipelines, inte versionspipelines.

Uppgifter som Visual Studio Test, .NET Core, Ant, Maven, Gulp och Grunt ger också möjlighet att publicera kodtäckningsdata till pipelinen. Om du använder dessa uppgifter behöver du inte en separat uppgift för att publicera kodtäckningsresultat i pipelinen.

Förutsättning – Om du vill använda aktiviteten Publicera kodtäckningsresultat v2 i pipelinen använder du aktiviteten dotnet 7.0.x som ett krav i pipelinen. Använd dotnet-kärnaktiviteten före aktiviteten Publicera kodtäckning v2.

Förutsättningar

Så här konfigurerar du förutsättningarna med hjälp av en YAML-pipeline:

# Dotnet core sdk task 7.0.x
- task: UseDotNet@2
  displayName: 'Use .NET Core sdk 7.0.x'
  inputs:
    version: 7.0.x

Så här konfigurerar du förutsättningarna med hjälp av designern:

Skärmbild som visar .Net Core Sdk-aktiviteten i pipelinen.

  1. Konfigurera uppgiften Publicera kodtäckningsresultat version 2 med hjälp av följande inställningar.

    Skärmbild som visar uppgiften Publicera kodtäckningsresultat v2

  2. När bygget har slutförts och uppgiften Publicera kodtäckningsresultat v2 har slutförts väljer du fliken Kodtäckning i sammanfattningen av pipelinekörningen för att visa resultatet av kodtäckningen.

    Skärmbild som visar fliken Kodtäckning som genereras av V2-aktiviteten Publicera kodtäckning

Kodtäckningsresultat för JavaScript med Istanbul med YAML

Information om hur du publicerar kodtäckningsresultat för JavaScript med Istanbul med YAML finns i Anpassa JavaScript i avsnittet Ekosystem i dessa avsnitt, som även innehåller exempel för andra språk.

Se ett exempel på publicering av kodtäckning med Cobertura.

Docker

För appar som använder Docker kan kompilering och tester köras i containern och generera kodtäckningsresultat i containern. För att kunna publicera resultaten till pipelinen bör de resulterande artefakterna göras tillgängliga för uppgiften Publicera kodtäckningsresultat . Som referens kan du se ett liknande exempel för publicering av testresultat under avsnittet Skapa, testa och publicera resultat med en Docker-fil för Docker.

Visa resultat

Information om hur du visar kodtäckningsresultaten i pipelinen finns i Granska kodtäckningsresultat.

Kända problem

Uppgiften publicera kodtäckningsresultat v2 genererar en cjson-fil och publicerar kodtäckningsrapporten under fliken kodtäckning. Den skapar också en byggartefakt som är en uppsättning HTML-filer som är länkade från huvudfilenindex.html . Om kodtäckningsfliken inte visar kodtäckningsrapporten kontrollerar du om XML-filen för indatakodtäckning har rätt format och har giltig information.

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version
Körs på Agent
Krav Ingen
Funktioner Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar Valfri
Inställningsbara variabler Valfri
Agentversion 2.144.0 eller senare
Uppgiftskategori Test

Se även