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

Ezzel a feladatsal közzéteheti a Cobertura- vagy JaCoCo-kódlefedettségi eredményeket egy buildből.

Fontos

Ez a feladat elavult. A felhasználóknak javasoljuk, hogy váltson PublishCodeCoverageResults@2. További információ: A Kódlefedettségi eredmények közzététele feladat új verziója.

Syntax

# Publish code coverage results v1
# [DEPRECATION WARNING! Users are recommended to switch to version 2*.] Publish Cobertura or JaCoCo code coverage results from a build.
- task: PublishCodeCoverageResults@1
  inputs:
    codeCoverageTool: 'JaCoCo' # 'Cobertura' | 'JaCoCo'. Required. Code coverage tool. Default: JaCoCo.
    summaryFileLocation: # string. Required. Summary file. 
    #pathToSources: # string. Path to Source files. 
    #reportDirectory: # string. Report directory. 
    #additionalCodeCoverageFiles: # string. Additional files. 
    #failIfCoverageEmpty: false # boolean. Fail when code coverage results are missing. Default: false.

Bevitelek

codeCoverageTool - Kódlefedettségi eszköz
string. Kötelező. Engedélyezett értékek: Cobertura, JaCoCo. Alapértelmezett érték: JaCoCo.

Meghatározza azt az eszközt, amely kódlefedettségi eredményeket hoz létre.

summaryFileLocation - Összegző fájl
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.

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.

Több forrás is hozzáadható, ha az egyes listaelemeket a karakterrel ; elválasztja, például pathToSources: $(System.DefaultWorkingDirectory)/path/to/first/source;$(System.DefaultWorkingDirectory)/path/to/second/source: .

reportDirectory - Jelentés könyvtára
string.

Megadja a kódlefedettségi HTML-jelentés könyvtárának elérési útját. A jelentés könyvtára közzé lesz téve, hogy később a build összetevőjeként tekinthesse meg. Az érték tartalmazhat minimális eltérési mintákat. Példa: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura.

additionalCodeCoverageFiles - További fájlok
string.

Megadja a fájl elérési útját, és megjegyzi a build összetevőiként közzéteendő további kódlefedettségi fájlokat. Az érték tartalmazhat minimális eltérési mintákat. Példa: $(System.DefaultWorkingDirectory)/**/*.exec.

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

Fontos

Ez a feladat elavult. A felhasználóknak javasoljuk, hogy váltson PublishCodeCoverageResults@2. További információ: A Kódlefedettségi eredmények közzététele feladat új verziója.

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álhatja a tesztek Azure Pipelinesban vagy TFS-ben való futtatásakor létrehozott kódlefedettségi eredmények közzétételére a lefedettségi jelentések beszerzéséhez. A feladat támogatja az olyan népszerű lefedettségi eredményformátumokat, mint a Cobertura és a JaCoCo.

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.

A HTML-kódlefedettségi jelentés létrehozásához dotnet-keretrendszer 2.0.0-s vagy újabb verziójára van szükség az ügynökön. A dotnet mappának a környezeti elérési úton kell lennie. Ha több mappa is tartalmaz dotnetet, a 2.0.0-s verziójú mappáknak az elérésiút-listában szereplő többi mappa előtt kell lenniük.

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.

A kódlefedettségi adatok egyesítve vannak, ha több fájlt adnak meg a tevékenység bemeneteként, vagy több tevékenységet használnak a folyamatban?

Jelenleg a feladat által biztosított kódlefedettségi jelentéskészítési funkció korlátozott, és nem egyesíti a lefedettségi adatokat. Ha több fájlt ad meg bemenetként a tevékenységhez, a rendszer csak az első egyezést veszi figyelembe. Ha több közzétételi kódlefedettségi feladatot használ a folyamatban, az összegzés és a jelentés az utolsó tevékenységhez jelenik meg. A korábban feltöltött adatok figyelmen kívül lesznek hagyva.

Ismert problémák

A kódlefedettségi eredmények közzététele feladat létrehozza és közzéteszi a HTML-jelentést, 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 index.html fájl mérete közel van-e vagy nagyobb-e 7 MB-nál. A fájl méretének ellenőrzéséhez hajtsa végre az alábbi lépéseket. Ha a fájlméret megközelíti vagy meghaladja a 7 MB-ot, az alábbi kerülő megoldással megtekintheti a lefedettségi jelentést.

1. Válassza a Build Summary (Összeállítás összegzése ) lapot, majd válassza a közzétett hivatkozást:

   

2. A Kódlefedettség Report_* összetevő mellett válassza az Összetevők letöltése lehetőséget:

   

3. A kódlefedettségi jelentés letöltésekor bontsa ki a .zip fájlt.

4. A kódlefedettségi jelentésben ellenőrizze a index.html méretét annak megállapításához, hogy a fájlméret okozza-e az itt leírt problémát.

5. Nyissa meg aindex.html böngészőben a kódlefedettségi jelentés megtekintéséhez.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build
Futtatás	Ügynök, DeploymentGroup
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	Ez a feladat a következő változók beállítására jogosult: A változók beállítása le van tiltva
Ügynök verziója	2.182.1 vagy újabb
Feladatkategória	Teszt

Lásd még

• Teszteredmények közzététele