Dela via

PublishCodeCoverageResults@2 – Publicera kodtäckningsresultat v2-uppgift

  • Artikel

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.

Ingångar

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 minimatchmönster. Till 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 mönstret $(System.DefaultWorkingDirectory)/MyApp/src/main/java/. Den här indatan bör peka på en absolut sökväg till källfilerna 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.


Alternativ för aktivitetskontroll

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

Utdatavariabler

Ingen.

Anmärkningar

Använd den här uppgiften i en byggpipeline för att publicera kodtäckningsresultat som genereras när du kör tester till Azure Pipelines eller TFS och efter att du har genererat xml-filerna för täckning för att få fliken kodtäckning och information om täckningsrapportering 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 kompileringsartefakterna.

Den här uppgiften stöds bara i byggpipelines, inte versionspipelines.

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

Förutsättning – Om du vill använda aktiviteten Publicera kodtäckningsresultat v2 i pipelinen använder du uppgiften dotnet 7.0.x som en förutsättning i pipelinen. Använd dotnet core-aktiviteten 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 aktiviteten 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 aktiviteten 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 ämnen, som även innehåller exempel på andra språk.

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

Stuveriarbetare

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 resultatet till pipelinen bör de resulterande artefakterna göras tillgängliga för Publicera kodtäckningsresultat uppgift. Som referens kan du se ett liknande exempel för att publicera testresultat under avsnittet Skapa, testa och publicera resultat med en Docker-fil för Docker.

Visa resultat

Information om hur du visar kodtäckningsresultatet 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 kompileringsartefakt som är en uppsättning HTML-filer som är länkade från huvudfilen index.html. Om fliken för kodtäckning 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
kräver Ingen
funktioner Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Någon
variabler som kan Någon
Agentversion 2.144.0 eller senare
Aktivitetskategori Test

Se även