PublishCodeCoverageResults@2 - Resultaten van codedekking publiceren v2-taak

Gebruik deze taak om resultaten van codedekking op te halen uit een build.

Syntaxis

# 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.

Ingangen

summaryFileLocation - pad naar overzichtsbestanden
string. Vereist.

Hiermee geeft u het pad op van het overzichtsbestand met codedekkingsstatistieken, zoals regel, methode en klassedekking. Meerdere overzichtsbestanden worden samengevoegd in één rapport. De waarde kan minimatchpatronen bevatten. Bijvoorbeeld: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml. Meer informatie over minimatchpatronen.

pathToSources - pad naar bronbestanden
string.

Het opgeven van een pad naar bronbestanden is vereist wanneer xml-rapporten van dekking geen absoluut pad naar bronbestanden bevatten. JaCoCo-rapporten gebruiken bijvoorbeeld geen absolute paden, dus bij het publiceren van JaCoCo-dekking voor Java-apps is het patroon vergelijkbaar met $(System.DefaultWorkingDirectory)/MyApp/src/main/java/. Deze invoer moet verwijzen naar een absoluut pad naar bronbestanden op de host. Bijvoorbeeld $(System.DefaultWorkingDirectory)/MyApp/.

Deze invoer kan worden gebruikt als tests worden uitgevoerd in een Docker-container.

failIfCoverageEmpty - mislukt als er resultaten van codedekking ontbreken
boolean. Standaardwaarde: false.

Mislukt de taak als de codedekking geen resultaten heeft geproduceerd om te publiceren.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak in een build-pijplijn om codedekkingsresultaten te publiceren die worden geproduceerd bij het uitvoeren van tests naar Azure Pipelines of TFS en nadat u de XML-dekkingsbestanden hebt gegenereerd om het tabblad codedekking en de details van de dekkingsrapportage in de pijplijn te verkrijgen. De taak ondersteunt gegenereerde XML-indelingen voor codedekking. Met deze taak wordt een cjson-bestand gegenereerd dat de details van de codedekking bevat. Het produceert ook een HTML-rapport met codedekking onder de buildartefacten.

Deze taak wordt alleen ondersteund in build-pijplijnen, niet in release-pijplijnen.

Taken zoals Visual Studio Test, .NET Core, Ant, Maven, Gulpen Grunt bieden ook de mogelijkheid om codedekkingsgegevens naar de pijplijn te publiceren. Als u deze taken gebruikt, hebt u geen afzonderlijke taak Voor het publiceren van codedekkingsresultaten in de pijplijn nodig.

Vereiste: als u de taak Codedekkingsresultaten v2 in de pijplijn wilt gebruiken, gebruikt u de dotnet 7.0.x taak als een vereiste in de pijplijn. Gebruik de dotnet-kerntaak vóór de taak Codedekking v2 publiceren.

Voorwaarden

De vereisten configureren met behulp van een YAML-pijplijn:

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

De vereisten configureren met behulp van de ontwerpfunctie:

1. Configureer de taak Publicatiecodedekkingsresultaten versie 2 met behulp van de volgende instellingen.

   

2. Nadat de build is voltooid en de taak Codedekkingsresultaten publiceren v2 is voltooid, selecteert u het tabblad Codedekking in de samenvatting van de pijplijnuitvoering om de resultaten van de codedekking weer te geven.

   

Resultaten van codedekking voor JavaScript met Istanbul met behulp van YAML

Zie JavaScript- aanpassen in de sectie Ecosystemen van deze onderwerpen, waaronder voorbeelden voor andere talen voor het publiceren van codedekkingsresultaten voor JavaScript met Istanbul.

Zie een voorbeeld van het publiceren van codedekking met behulp van Cobertura.

Dokwerker

Voor apps die Docker gebruiken, kunnen build- en tests worden uitgevoerd in de container en codedekkingsresultaten genereren binnen de container. Als u de resultaten naar de pijplijn wilt publiceren, moeten de resulterende artefacten beschikbaar worden gesteld aan de Publicatiecodedekkingsresultaten taak. Ter referentie ziet u een vergelijkbaar voorbeeld voor het publiceren van testresultaten onder de Build, test en publish results with a Docker file section for Docker.

Resultaten weergeven

Zie De resultaten van de codedekking bekijkenom de resultaten van de codedekking in de pijplijn weer te geven.

Bekende problemen

De publicatiecodedekkingsresultaten v2-taak genereert een cjson-bestand en publiceert het codedekkingsrapport onder het tabblad Codedekking. Het produceert ook een buildartefacten die een set HTML-bestanden is die zijn gekoppeld vanuit het hoofdbestand index.html. Als het tabblad Codedekking het codedekkingsrapport niet kan weergeven, controleert u of het XML-bestand voor de invoercodedekking de juiste indeling heeft en de geldige gegevens bevat.

Eisen

Eis	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Enig
variabelen instellen	Enig
Agentversie	2.144.0 of hoger
Taakcategorie	Test

Zie ook

• testresultaten publiceren