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