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

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

Megjegyzés

PublishCodeCoverageResults@2 a feladat legújabb verziója, amelyet a folyamatokban kell használni. A v1 feladat elavult lesz.

Szintaxis

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

Bemenetek

codeCoverageTool - Kódlefedettségi eszköz
string. Szükséges. Engedélyezett értékek: Cobertura, JaCoCo. Alapértelmezett érték: JaCoCo.

Megadja a kódlefedettségi eredményeket létrehozó eszközt.

summaryFileLocation - összefoglaló fájl
string. Szükséges.

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

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

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, ezért a JaCoCo-lefedettség Java-alkalmazásokhoz való közzétételekor a minta hasonló a $(System.DefaultWorkingDirectory)/MyApp/src/main/java/. 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ó az egyes listaelemek ; karakterrel való elválasztásával, például pathToSources: $(System.DefaultWorkingDirectory)/path/to/first/source;$(System.DefaultWorkingDirectory)/path/to/second/source.

reportDirectory - jelentéskönyvtár
string.

Megadja a kódlefedettségi HTML-jelentés könyvtárának elérési útját. A jelentéskönyvtár közzétételre kerül, hogy később a build összetevőjeként tekintsen meg. Az érték tartalmazhat minimális eltérési mintákat. Például: $(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éldául: $(System.DefaultWorkingDirectory)/**/*.exec.

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

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

Tevékenységvezérlési beállítások

Minden tevékenység a tevékenységbemeneteken kívül vezérlési lehetőségekkel is rendelkezik. További információ: Vezérlők és gyakori feladattulajdonságok.

Kimeneti változók

Egyik sem.

Megjegyzések

Ezzel a feladatsal egy buildelési folyamatban közzéteheti a tesztek Azure Pipelinesban vagy TFS-ben való futtatásakor létrehozott kódlefedettségi eredményeket a lefedettségi jelentések beszerzése érdekében. A feladat támogatja a népszerű lefedettségi eredményformátumokat, például Cobertura és JaCoCo.

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

Az olyan feladatok, mint Visual Studio Test, .NET Core, Ant, Maven, Gulpés Grunt is 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 feladatra 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ának az elérésiút-listában szereplő többi mappa előtt kell lennie.

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

A JavaScript és isztambuli kódlefedettségi eredmények YAML használatával való közzétételéhez tekintse meg a témakörök Ökoszisztémák szakaszában található JavaScript- testreszabását, amely példákat is tartalmaz más nyelvekre.

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

Kikötőmunkás

A Dockert használó alkalmazások esetében a buildek és tesztek futtathatók a tárolóban, és kódlefedettségi eredményeket hozhatnak létre a tárolóban. Annak érdekében, 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. A Docker-fájl szakaszában hasonló példa látható a teszteredmények közzétételére a Docker-.

Eredmények megtekintése

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

A kódlefedettségi adatok egyesülnek, 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ési funkció korlátozott, és nem egyesít lefedettségi adatokat. Ha több fájlt ad meg bemenetként a feladathoz, 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 készlete. Ha a kódlefedettségi lap nem jeleníti meg 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. Ezután, ha a fájl mérete 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 Összegzés lapot, majd válassza a közzétett hivatkozást:

   

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

   

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 a index.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 bekapcsolva	Ügynök, DeploymentGroup
Követelmények	Egyik sem
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ármely
Változók beállítása	Ez a feladat jogosult a következő változók beállítására: A változók beállítása le van tiltva
Ügynök verziója	2.182.1 vagy újabb
Tevékenységkategória	Teszt

Lásd még:

• Teszteredmények közzététele