PublishCodeCoverageResults@2 – Kódlefedettségi eredmények közzététele v2 feladat

Ezzel a feladatsal kódlefedettségi eredményeket kaphat egy buildből.

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.

Bevitelek

summaryFileLocation - Az összefoglaló fájlok elérési útja
string. Kötelező.

Megadja a kódlefedettségi statisztikákat tartalmazó összegző fájl elérési útját, például a sor-, a metódus- és az osztálylefedettségi adatokat. A rendszer több összefoglaló fájlt egyesít egyetlen jelentéssel. Az érték tartalmazhat minimális eltérési mintákat. Példa: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml. További információ a minimatch mintákról.

pathToSources - Forrásfájlok elérési útja
string.

A forrásfájlok elérési útjának megadása akkor szükséges, ha a lefedettségi XML-jelentések nem tartalmaznak abszolút elérési utat a forrásfájlokhoz. A JaCoCo-jelentések például nem használnak abszolút elérési utakat, így a JaCoCo-lefedettség Java-alkalmazásokhoz való közzétételekor a minta a következőhöz $(System.DefaultWorkingDirectory)/MyApp/src/main/java/hasonló: . Ennek a bemenetnek a gazdagépen található forrásfájlok abszolút elérési útjára kell mutatnia. Például: $(System.DefaultWorkingDirectory)/MyApp/.

Ez a bemenet akkor használható, ha a teszteket Docker-tárolóban futtatják.

failIfCoverageEmpty - Sikertelen, ha hiányoznak a kódlefedettségi eredmények
boolean. Alapértelmezett érték: false.

A feladat meghiúsul, ha a kódlefedettség nem eredményezett közzétételi eredményt.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Megjegyzés

A Kódlefedettségi eredmények közzététele tevékenység új verziójáról az Azure DevOps blogján tájékozódhat a Kódlefedettségi eredmények közzététele feladat 2- es verziójának új funkcióiról, valamint a V1-ről a V2-re való migrálásról.

Ezt a feladatot egy buildfolyamatban használva közzéteheti a tesztek Azure Pipelinesban vagy TFS-ben való futtatásakor és a lefedettségi XML-fájlok létrehozása után létrehozott kódlefedettségi eredményeket a kódlefedettségi lap és a lefedettség jelentési részleteinek beszerzéséhez a folyamatban. A feladat támogatja a kódlefedettség által generált XML-formátumokat. Ez a feladat létrehoz egy cjson-fájlt, amely tartalmazza a kódlefedettség részleteit. Emellett kódlefedettségi HTML-jelentést is készít a buildösszetevők alatt.

Ez a feladat csak a buildfolyamatokban támogatott, a kiadási folyamatokban nem.

Az olyan feladatok, mint a Visual Studio Test, a .NET Core, az Ant, a Maven, a Gulp és a Grunt , szintén lehetővé teszik a kódlefedettségi adatok közzétételét a folyamaton. Ha ezeket a feladatokat használja, nincs szükség külön Közzétételi kódlefedettségi eredmények tevékenységre a folyamatban.

Előfeltétel – A kódlefedettségi eredmények közzététele v2 feladatnak a folyamatban való használatához használja a dotnet 7.0.x feladatot a folyamat előfeltételeként. Használja a dotnet core feladatot a Kódlefedettség közzététele v2 tevékenység előtt.

Előfeltételek

Az előfeltételek konfigurálása YAML-folyamattal:

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

Az előfeltételek konfigurálása a tervezővel:

1. Konfigurálja a Kódlefedettségi eredmények közzététele 2. verziójának feladatát az alábbi beállításokkal.

   

2. Miután a build befejeződött, és a Kódlefedettségi eredmények közzététele v2 feladat sikeres volt, válassza a Kódlefedettség lapot a folyamatfuttatás összegzésében a kódlefedettségi eredmények megtekintéséhez.

   

Kódlefedettségi eredmények JavaScripthez Isztambulnal YAML használatával

A JavaScript és Isztambul kódlefedettségi eredményeinek YAML használatával történő közzétételéhez tekintse meg a JavaScript testreszabását a témakörök Ökoszisztémák szakaszában, amely más nyelvekre is tartalmaz példákat.

Lásd egy példát a kódlefedettség Cobertura használatával történő közzétételére.

Docker

A Dockert használó alkalmazások esetében előfordulhat, hogy a buildek és tesztek a tárolóban futnak, és kódlefedettségi eredményeket hoznak létre a tárolóban. Ahhoz, hogy az eredményeket közzétehesse a folyamaton, az eredményként kapott összetevőket elérhetővé kell tenni a Kódlefedettségi eredmények közzététele feladat számára. Referenciaként láthat egy hasonló példát a teszteredmények közzétételére a Dockerhez készült Docker-fájllal rendelkező buildelési, tesztelési és közzétételi szakaszban.

Eredmények megtekintése

A kódlefedettségi eredményeknek a folyamatban való megtekintéséhez lásd: Kódlefedettségi eredmények áttekintése.

Ismert problémák

A kódlefedettségi eredmények közzététele v2 feladat létrehoz egy cjson-fájlt, és közzéteszi a kódlefedettségi jelentést a kódlefedettség lapon. Emellett létrehoz egy buildösszetevőt is, amely a fő index.html fájlból csatolt HTML-fájlok halmaza. Ha a kódlefedettségi lap nem tudja megjeleníteni a kódlefedettségi jelentést, ellenőrizze, hogy a bemeneti kódlefedettségi XML-fájl a megfelelő formátumban van-e, és rendelkezik-e az érvényes részletekkel.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build
Futtatás	Ügynök
Igények	None
Képességek	Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	2.144.0 vagy újabb
Feladatkategória	Teszt

Lásd még

• Teszteredmények közzététele