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.
Ezzel a feladatsal közzéteheti a Cobertura- vagy JaCoCo-kódlefedettségi eredményeket egy buildből.
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.
# Publish code coverage results v1
# 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.
# Publish Code Coverage Results v1
# 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.
#reportDirectory: # string. Report directory.
#additionalCodeCoverageFiles: # string. Additional files.
#failIfCoverageEmpty: false # boolean. Fail when code coverage results are missing. Default: false.
# YAML Syntax is not supported in TFS 2018.
# Use the classic designer to add and configure tasks.
# See the following Inputs section for details on the inputs that this task supports.
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.
Válassza a Build Summary (Összeállítás összegzése ) lapot, majd válassza a közzétett hivatkozást:
A Kódlefedettség Report_* összetevő mellett válassza az Összetevők letöltése lehetőséget:
A kódlefedettségi jelentés letöltésekor bontsa ki a .zip fájlt.
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.
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 |
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build |
Futtatás: | Ügynök, DeploymentGroup |
Igények | None |
Képességek | Ez a tevékenység 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.102.0 vagy újabb |
Feladatkategória | Teszt |