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äckningsresultat på Azure 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:
Konfigurera uppgiften Publicera kodtäckningsresultat version 2 med hjälp av följande inställningar.
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.
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 |