Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Minden jelentésbeállításhoz szükség van a szakaszában elnevezett bővítménycsomagra. Adja hozzá közvetlenül a csomagot, vagy használjon egy teszt SDK-konfigurációt vagy profilt, amely tartalmazza azt. A jelentésbővítmények nem képezik az MTP alapvető részét, ezért egy olyan beállítást, mint a --report-trx, a tesztalkalmazás nem ismer fel, ha nem regisztrálja annak bővítményét. Futtassa a tesztalkalmazást a(z) --help használatával, vagy futtassa a(z) dotnet test --help elemet MTP módban, hogy meggyőződjön arról, hogy elérhető-e egy opció.
Jótanács
A Microsoft.Testing.Platform.MSBuild (amelyet az MSTest, az NUnit és az xUnit tesztfutók tranzitívan tartalmaznak) használatakor ezek a bővítmények automatikusan regisztrálásra kerülnek a NuGet-csomagok telepítésekor – nincs szükség a kód módosítására. A cikkben megadott manuális regisztrációra csak akkor van szükség, ha a beállítással <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>letiltotta az automatikusan létrehozott belépési pontot.
Jelentésfájlnevek
Minden jelentéskiterjesztés a fájlját a teszteredmények könyvtárába írja, amelyet a(z) --results-directory kapcsolóval adhat meg. A név felülírásához használja a hozzá tartozó --report-*-filename beállítást. Minden jelentésszakasz felsorolja a jelentés alapértelmezett nevét.
A fájlnevek tartalmazhatnak relatív elérési utat, amely a teszteredmények könyvtárában marad, és a következő helyettesítő elemeket (helyőrzőket) használhatja:
| Placeholder | Description |
|---|---|
{asm} |
A bejegyzés-összeállítás neve, vagy unknown, ha nem áll rendelkezésre. |
{tfm} |
A futásidőben észlelt célkeretrendszer megnevezése, például net9.0. |
{arch} |
Folyamatarchitektúra, például x64, x86vagy arm64. |
{pname} |
Folyamat neve. |
{pid} |
Folyamatazonosító. |
{time} |
Nagy pontosságú időbélyeg. |
Például --report-trx-filename "{asm}_{tfm}_{arch}.trx" reprodukálja az alapértelmezett TRX-nevet.
Ha már létezik alapértelmezett vagy explicit TRX-, HTML- vagy JUnit-fájlnév egy tesztforráshoz, a bővítmény figyelmezteti és felülírja a fájlt. Az MTP 2.4-től kezdve a CTRF ugyanazt a viselkedést használja. A jelentéselőzmények megőrzéséhez a következőket kell tartalmaznia {time}: .
Megjegyzés:
A helyőrzőnevek megkülönböztetik a kis- és nagybetűket, és kisbetűsek. A jelentésfájlnevek helyőrző támogatása az MTP-ben érhető el a 2.3.0-s verziótól kezdve.
Jelentéskonszolidáció
Az MTP 2.4.0-tól kezdve az MTP automatikusan feldolgozza a jelentésösszetevőket, miután egy dotnet test meghívás több tesztmodult futtat, vagy miután újrapróbálkozás után a támogatás több kísérletet is futtat. A funkció kísérleti jellegű az MTP 2.4.0-s verzióban.
A TRX, JUnit, CTRF és HTML-bővítmények jelentéstípus szerint csoportosítják a kompatibilis összetevőket, és konszolidált jelentést írnak a teszteredmény-könyvtár alkönyvtárában merged . A CTRF-összevonás egyesíti a modulok eredményeit, és az újrapróbálkozásokat az újrapróbálkozási előzményekkel együtt a végső teszteredménybe vonja össze. A HTML-összevonás egyesített összegzést hoz létre, és megőrzi az eredeti folyamatonkénti jelentéseket.
Az egyéni jelentésbővítmények esetében a kísérleti IArtifactPostProcessor API külön TestModules és RetryAttempts feldolgozási módokat tesz elérhetővé. További információ: A IArtifactPostProcessor bővítmények.
Visual Studio tesztjelentések (TRX)
A teszteredmények közzétételének alapértelmezett formátuma a Visual Studio teszteredményfájl (vagy TRX). Ehhez a bővítményhez a Microsoft.Testing.Extensions.TrxReport NuGet csomag szükséges.
Manuális regisztráció
var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddTrxReportProvider();
Megjegyzés:
Manuális regisztráció használatakor regisztrálja utoljára a TRX jelentésszolgáltatót. Az aktuális implementáció a regisztrációs sorrendtől függ, ezért az összes többi bővítmény után történő regisztrálás biztosítja az összes tesztadat rögzítését.
Megjegyzés:
Az 1.9.0-s verziótól kezdve elérhető MTP-ben a TRX-jelentés tartalmazza a tesztmezőt Description .
Megjegyzés:
Az MTP-ben a 2.3.0-s verziótól kezdve a TRX-eredmények a futtatás előrehaladtával folyamatosan a lemezre íródnak. Ha a tesztgazda összeomlik, a TRX-fájl megőrzi az összeomlás előtt összegyűjtött eredményeket.
Az MTP 2.4-től kezdve a TRX alapértelmezés szerint vezérlő által támogatott helyreállítást használ, ha a platform rendelkezik teszt-gazdagépvezérlővel. A böngésző, a WASI, az iOS és a tvOS a folyamaton belüli kompatibilitási útvonalat használja.
Az MTP 2.4-től kezdve az MTP által generált TRX megőrzi az MSTest [WorkItem] és [GitHubWorkItem] metaadatokat.
Beállítások
| Lehetőség | Description |
|---|---|
--report-trx |
Létrehozza a TRX-jelentést. |
--report-trx-filename |
A létrehozott TRX-jelentés neve. Az MTP 2.3.0-tól kezdődően az alapértelmezett érték a determinisztikus {asm}_{tfm}_{arch}.trx forma; az MTP 2.3.0 előtt az alapértelmezett érték volt <UserName>_<MachineName>_<yyyy-MM-dd_HH_mm_ss.fffffff>.trx. A név testreszabásához tekintse meg a jelentésfájlneveket. |
A jelentés az alapértelmezett TestResults mappába kerül, amely a --results-directory parancssori argumentumon keresztül adható meg.
HTML-jelentések
A HTML-jelentés egy interaktív, önálló HTML-fájlt hoz létre egy tesztmunkamenethez. Ehhez a bővítményhez a Microsoft.Testing.Extensions.HtmlReport NuGet-csomag szükséges.
Megjegyzés:
Az MTP-ben a 2.3.0-s verziótól kezdve érhető el. Ez a bővítmény kísérleti jellegű, és a beállításai és a kimeneti formátuma megváltozhat egy későbbi verzióban.
Manuális regisztráció
var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddHtmlReportProvider();
Beállítások
| Lehetőség | Description |
|---|---|
--report-html |
Létrehozza a HTML-jelentést. |
--report-html-filename |
A létrehozott HTML-jelentés neve. Az értéknek a következővel kell végződnie .html: . Az alapértelmezett érték a {asm}_{tfm}_{arch}.html. A név testreszabásához tekintse meg a jelentésfájlneveket. Szükséges --report-html. |
JUnit-jelentések
A JUnit-jelentés létrehoz egy JUnit-kompatibilis XML-fájlt egy tesztmunkamenethez. Ehhez a bővítményhez a Microsoft.Testing.Extensions.JUnitReport NuGet-csomag szükséges.
Megjegyzés:
Az MTP-ben a 2.3.0-s verziótól kezdve érhető el. Ez a bővítmény kísérleti jellegű, és a beállításai és a kimeneti formátuma megváltozhat egy későbbi verzióban.
Az MSTest.Sdk 4.3-as verziójától kezdve a(z) <EnableMicrosoftTestingExtensionsJUnitReport>true</EnableMicrosoftTestingExtensionsJUnitReport> használatával lehet engedélyezni ezt a bővítményt. A bővítmény nem része az DefaultAllMicrosoft MSTest.Sdk-profilnak.
Manuális regisztráció
var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddJUnitReportProvider();
Beállítások
| Lehetőség | Description |
|---|---|
--report-junit |
Létrehozza a JUnit XML-jelentést. |
--report-junit-filename |
A létrehozott JUnit XML-jelentés neve. Az értéknek a következővel kell végződnie .xml: . Az alapértelmezett érték a {asm}_{tfm}_{arch}.xml. A név testreszabásához tekintse meg a jelentésfájlneveket. Szükséges --report-junit. |
CTRF-jelentések
A CTRF-jelentés létrehoz egy JSON-fájlt, amely a Common Test Report Formátumot használja egy tesztmunkamenethez. Ehhez a bővítményhez a Microsoft.Testing.Extensions.CtrfReport NuGet-csomag szükséges.
Megjegyzés:
Az MTP-ben a 2.3.0-s verziótól kezdve érhető el. Ez a bővítmény kísérleti jellegű, és a beállításai és a kimeneti formátuma megváltozhat egy későbbi verzióban.
Manuális regisztráció
var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddCtrfReportProvider();
Beállítások
| Lehetőség | Description |
|---|---|
--report-ctrf |
Létrehozza a CTRF JSON-jelentést. |
--report-ctrf-filename |
A létrehozott CTRF JSON-jelentés neve. Az értéknek a következővel kell végződnie .json: . Az alapértelmezett érték a <UserName>_<MachineName>_<assembly>_<tfm>_<timestamp>.ctrf.json. A név testreszabásához tekintse meg a jelentésfájlneveket. Szükséges --report-ctrf. |
Az MTP 2.4-től kezdve a CTRF megőrzi az összes eredményt, ha több teszt ugyanazt a UID-t használja. Tesztenkénti és előzetes kísérletes mellékleteket is tartalmaz, és a fájlnevekből következtet a MIME-típusukra.
Az újrapróbálkozott tesztek esetében a CTRF csak akkor korrelálja a kísérleteket, ha a kapcsolat egyértelmű. Ezután rögzíti a korábbi kísérleteket a(z) retryAttempts alatt, a(z) retries értékre állítja, majd a későbbi sikeres eredményt flaky: trueként jelöli meg. A nem egyértelmű, azonos UID-jű eredmények külön maradnak, így a jelentés nem társítja a diagnosztikát a nem megfelelő teszthez.
Az MTP 2.5 előzetes verziójától testId kezdve a keretrendszer teljes MTP-tesztcsomópont UID-jából származik. A jelentéskészítő a fenntartott identitás-névtereiben escape-eli az értékeket, és a hosszú UID-k levágása helyett determinisztikus SHA-256-azonosítót használ. Minden jelentett végrehajtás új UUID-azonosítót kap, executionIdés a korábbi újrapróbálkozási kísérletek a sajátjukat attemptIdkapják. A kompatibilitási mező extra.uid megőrzi az eredeti MTP UID azonosítót. A melléklet elérési útjai átlátszatlan értékek maradnak, és olyan helyi fájlokra mutathatnak, amelyeket egy távoli fogyasztó nem tud elérni.
A terminál összegzése azonosítja a pelyhes és újrapróbálkozott teszteket. A TRX- és JUnit-jelentések tesztenként egy végső eredményt tárolnak ahelyett, hogy minden kísérletet rögzítenének.
Azure DevOps jelentések
Az Azure DevOps jelentésbővítmény integrálja az MTP tesztfuttatásait az Azure Pipelinesba. Formázja a folyamatnaplók hibáit és figyelmeztetéseit, széljegyzeteket ad hozzá a sikertelen és kihagyott tesztekhez, létrehoz egy Markdown-feladat összefoglalását, és a kimenetet tesztszerelvények szerint csoportosíthatja. A bővítmény emellett azonosítani tudja az instabil vagy karanténba helyezett sikertelen teszteket, feltöltheti a teszt-artefaktumokat, és folyamatosan továbbíthatja az eredményeket egy Azure DevOps-tesztfuttatásba.
Ha a kódot GitHub üzemelteti, de teszteket futtat Azure Pipelines ügynökökön, a hibajegyzetek közvetlenül megjelenhetnek a GitHub lekéréses kérelemben:
Ehhez a bővítményhez a Microsoft.Testing.Extensions.AzureDevOpsReport NuGet csomag szükséges.
Manuális regisztráció
var builder = await TestApplication.CreateBuilderAsync(args);
builder.TestHost.AddAzureDevOpsProvider();
Beállítások
| Lehetőség | MTP-verzió | Description |
|---|---|---|
--report-azdo |
1.9.0 | Engedélyezi a Azure DevOps jelentésgenerátort. A hibák és figyelmeztetések a kimenetbe Azure DevOps érthető formátumban vannak megírva. |
--report-azdo-severity |
1.9.0 | A jelentett eseményekhez használt súlyossági szint. Az érvényes értékek az (alapértelmezett) és a errorwarning. |
--report-azdo-groups |
2.4.0 | Engedélyezi vagy letiltja a szerelvényenkénti naplócsoportokat. Ha engedélyezve van, az egyes tesztszerelvények kimenete a Azure Pipelines napló összecsukható szakaszában jelenik meg. Az érvényes értékek a következők: on és off. Az MTP 2.4.0 előzetes buildjei alapértelmezés szerint a on értéket használják; a stabil MTP 2.4.0 kiadás alapértelmezés szerint a off értéket használja. Szükséges --report-azdo. |
--report-azdo-annotations |
2.4.0 | Engedélyezi vagy letiltja a sikertelen és kihagyott tesztekhez tartozó széljegyzeteket. Az érvényes értékek az (alapértelmezett) és a onoff. Szükséges --report-azdo. |
--report-azdo-flaky-history |
2.3.0 | Lekérdezi az Azure DevOpsban az elmúlt N nap (1–90) teszteredmény-előzményeit, és a jelentett hibákat instabilitási kontextussal látja el. Szükséges --report-azdo. |
--report-azdo-demote-known-flaky |
2.3.0 | Az Azure DevOps előzményablakában kellően instabil hibákat (az alapértelmezett küszöbérték 25%) hibáról figyelmeztetésre minősíti vissza. A következő elemek szükségesek: --report-azdo és --report-azdo-flaky-history. |
--report-azdo-slow-test-history |
2.3.0 | Lekérdezi az Azure DevOps teszteredményeinek előzményeit a megadott számú napra visszamenően, és csökkenti a tesztenkénti, még futónak tekintési küszöbértéket az ismerten rövid futásidejű tesztek esetében. Pontosan egy egész számot fogad el 1 és 90 között. Elegendő historikus mintával a küszöbérték a 60 másodperc és a konfigurált szorzóval megszorzott historikus p99-időtartam közül az alacsonyabb érték. Szükséges --report-azdo. |
--report-azdo-slow-test-history-min-sample |
2.3.0 | Beállítja az előzményminták minimális számát, amely ahhoz szükséges, hogy a bővítmény egy teszt előzményei alapján állítsa be a lassú tesztelési küszöbértéket, vagy adja hozzá az előzményadatokat a lassú teszt kimeneti soraihoz. Pontosan egy 1-nél nagyobb vagy egyenlő egész számot fogad el. Az alapértelmezett érték 10. Szükséges --report-azdo-slow-test-history. |
--report-azdo-slow-test-history-multiplier |
2.3.0 | Beállítja a teszt előzmény p99-időtartamára alkalmazott szorzót a lassú teszt küszöbértékének kiszámításához. Pontosan egy 0-nál nagyobb, legfeljebb 10 000-nél nagyobb invariáns kulturális lebegőpontos értéket fogad el. Az alapértelmezett érték 3. Szükséges --report-azdo-slow-test-history. |
--report-azdo-quarantine-file |
2.3.0 | Azon tesztek teljesen minősített neveit vagy glob mintáit felsoroló szövegfájl elérési útja, amelyek karanténba vannak helyezve. Az egyeztetési hibák figyelmeztetésként jelennek meg. Szükséges --report-azdo. |
--report-azdo-summary |
2.3.0 | A tesztfuttatás végén Markdown formátumú feladat-összefoglalót ír, és a(z) ##vso[task.uploadsummary] használatával feltölti. A választható fájlelérési útvonal argumentum felülírja az alapértelmezett helyet ({testResultsDir}/azdo-summary-{assembly}-{tfm}-{arch}.md). Szükséges --report-azdo. |
--report-azdo-stackframe-filter |
2.3.0 | Regexmintákat ad hozzá, amelyek az egyes veremkeretek teljesen minősített típusa előtagjára illeszkednek, és amelyeket a bővítmény figyelmen kívül hagy, amikor megkeresi a felhasználó annotálandó hívási helyét. Az opció többször is megadható, legfeljebb 16 mintáig, és minden minta 500 ms-os egyezési időkorláttal kerül lefordításra. Ezek a minták a bővítmény beépített MSTest assertion-implementációs előtagjaihoz adnak adalékot. Szükséges --report-azdo. |
--report-azdo-upload-artifacts |
2.3.0 | Feltölti a teszteredményfájlokat, és/vagy buildcímkéket ad hozzá a Azure DevOps. Az érvényes értékek a következők off : (alapértelmezett), tags-onlyfilesés all. |
--report-azdo-upload-artifact-include |
2.3.0 | A teszteredmények könyvtárához viszonyított glob minták alapján fájlokat foglal bele az Azure DevOps-műtermék feltöltésébe. Alapértelmezett érték: **/*. Megköveteli, hogy a(z) --report-azdo-upload-artifacts értéke ne off legyen. |
--report-azdo-upload-artifact-exclude |
2.3.0 | Kizárja a fájlokat az Azure DevOps-buildtermék feltöltéséből, a teszteredmények könyvtárához viszonyított globminták alapján. Megköveteli, hogy a(z) --report-azdo-upload-artifacts értéke ne off legyen. |
--report-azdo-upload-artifact-name |
2.3.0 | Felülbírálja a Azure DevOps összetevőtároló nevét. Alapértelmezett érték: TestResults_{assemblyName}_{tfm}. Megköveteli, hogy a(z) --report-azdo-upload-artifacts értéke ne off legyen. |
--publish-azdo-test-results |
2.3.0 | Az eredményeket egy Azure DevOps tesztre streameli, amint a tesztek befejeződnek. A build Tesztek lapja felsorolja a befejezett futtatásokat. |
--publish-azdo-run-name |
2.3.0 | Egyéni Azure DevOps tesztfuttatás nevét állítja be az élő teszteredmények közzétételéhez. Szükséges --publish-azdo-test-results. |
Warning
Ne engedélyezze a csoportokat, ha több teszt-összeállítás fut párhuzamosan.
##[group] Azure DevOps és ##[endgroup] formázási parancsok egymást követő és névtelenek. Az egyidejű szerelvénykimenetek átjárhatják egymást, helytelen csoportbe ágyazást okozhatnak, és helytelen szerelvény alá helyezhetik a sorokat. Ha az MTP 2.4.0 előzetes buildjét használja, a csoportok letiltásához adja meg a(z) --report-azdo-groups off értéket. A stabil MTP 2.4.0-s kiadás alapértelmezés szerint letiltja a csoportokat. A(z) --report-azdo-groups on paramétert csak egyetlen assemblyhez vagy sorosított assembly-végrehajtáshoz adja át.
Megjegyzés:
Az MTP-verzió oszlop felsorolja az egyes beállításokat tartalmazó első MTP-verziót. Maga az Azure DevOps-bővítmény az MTP 1.9.0-ban vált stabillá a --report-azdo és --report-azdo-severity használatával; a többi lehetőséget az MTP 2.3.0-ban vagy 2.4.0-ban adták hozzá.
A bővítmény a környezeti változó ellenőrzésével TF_BUILD automatikusan észleli, hogy folyamatos integrációs (CI) környezetben fut.
Important
Azure DevOps előzmény lekérdezések megkövetelik TF_BUILD=true, SYSTEM_COLLECTIONURI, SYSTEM_TEAMPROJECT, SYSTEM_ACCESSTOKENés BUILD_DEFINITIONID. Ha valamelyik érték hiányzik, az MTP az előzmények adatai nélkül folytatja, kihagyja a pelyhes előzményjegyzeteket, és a lassú tesztvonalak statikus 60 másodperces küszöbértékét használja.
A(z) --publish-azdo-test-results használatával történő élő közzétételhez TF_BUILD=true, SYSTEM_COLLECTIONURI, SYSTEM_TEAMPROJECT, SYSTEM_ACCESSTOKEN és BUILD_BUILDID szükséges. Ha valamelyik érték hiányzik vagy érvénytelen, az MTP figyelmezteti, és nem teszi közzé a tesztfuttatást.
Az MTP 2.4.0-tól kezdve Azure DevOps Markdown-összegzések összesítik az eredményeket az összes tesztmodulban egy dotnet test meghívásban. Ha a kódlefedettség is engedélyezve van, az összegzés tartalmazza a fedezett és a teljes számokat, a százalékos értékeket, a küszöbérték-eredményeket, valamint egy mutatót, ha a lefedettségi adatok részlegesek.
Az MTP 2.5 előzetes verziójától kezdve az összegzés a passzrátákat, a pelyhes tesztelőzményeket, az időtartam-összehasonlításokat, a függőségi élek tesztelését, a szűrt hibadiagnosztikát és a többmodulos futtatások kompakt determinisztikus elrendezését is tartalmazza.
Az MTP 2.4-es verziójától kezdve az azonnali közzététel automatikusan feltölti a sikertelen eredményekhez tartozó fájlmellékleteket az Azure DevOps teszteredményei közé. A sikertelen kimenetelek közé tartoznak a sikertelen, a hibával végződő, az időtúllépés miatti és a megszakított kimenetelek.
Ha egy eredmény szabványos kimenetet vagy standard hibát ad meg, a bővítmény legfeljebb 256 KiB-t csatolhat az egyes beágyazott streamekhez. Minden fájlalapú melléklethez 16 MiB-os korlát tartozik.
A bővítmény emellett futtatási szintű .coverage, .cobertura.xmlés .opencover.xml fájlokat is feltölt kódlefedettségi mellékletként. Ezek a tesztfuttatási és eredménymellékletek eltérnek a kiválasztott fájlok Azure Pipelines buildelési összetevőkként való feltöltésétől--report-azdo-upload-artifacts.
Az újrapróbálkozott tesztek esetében Azure DevOps a korábbi kísérleteket részjelentésekként teszi közzé, és az egyes kísérletek összetevőit az őket eredményező alresultsághoz csatolja. Ha a biztonságos újrapróbálkozási korreláció nem érhető el, a bővítmény a kihagyás helyett külön eredményt tesz közzé.
Amikor az élő közzététel létrehozza a futtatást, kinyomtatja a futtatási URL-címet, így a befejezés előtt követheti az eredményeket. Elküldi a pipelineReference elemet és a kezdési dátumot is, ha a pipeline-környezet biztosítja ezeket. A build Tesztek lapja nem sorol fel folyamatban lévő futtatásokat; a befejezés utáni futtatásokat sorolja fel.
GitHub Actions jelentések
A GitHub Actions-jelentés a GitHub Actions natív munkafolyamat-parancsait adja ki, így a tesztfuttatások elsőrangú élményt nyújtanak a futtatókörnyezetben: összeállításonkénti naplócsoportokat, sikertelen és kihagyott tesztek annotációit (amelyek a munkafolyamat Annotations lapján jelennek meg, illetve amikor a forráshely feloldható, a lekérési kérelem Files changed diffjében is), a GITHUB_STEP_SUMMARY által hivatkozott fájlhoz hozzáfűzött Markdown-formátumú feladat-összefoglalót, valamint a lassú tesztekre vonatkozó értesítéseket.
A bővítményhez szükség van a Microsoft.Testing.Extensions.GitHubActionsReport NuGet-csomagra.
A bővítmény csak akkor aktiválódik, ha a futtatás GitHub Actions van (a GITHUB_ACTIONS környezeti változó true) és a --report-gh kapcsoló be van állítva; ellenkező esetben semmit sem tesz. Ha be van kapcsolva, minden funkció alapértelmezés szerint engedélyezett, és a saját --report-gh-* beállításával külön-külön kikapcsolható.
Important
Az --report-gh beállítás ehhez tartozik: Microsoft.Testing.Extensions.GitHubActionsReport. A GitHubActionsTestLogger csomag egy másik lehetőséget kínál. --report-github A beállítások nem aliasok, és csak akkor működnek, ha a tesztprojekt regisztrálja azt a csomagot, amely a beállítás tulajdonosa.
Megjegyzés:
A bővítmény az MTP 2.3.0-tól érhető el. Az MTP 2.4.0-tól kezdve a nyilvános belépési pontok már nem kísérleti jellegűek.
Manuális regisztráció
var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddGitHubActionsProvider();
Beállítások
| Lehetőség | MTP-verzió | Description |
|---|---|---|
--report-gh |
2.3.0 | Engedélyezi a GitHub Actions jelentésgenerátort, így a teszt munkafolyamat-parancsokat bocsát ki. A futtatásnak a GitHub Actionsben kell történnie. |
--report-gh-groups |
2.3.0 | Engedélyezi vagy letiltja a szerelvényenkénti naplócsoportokat. Az érvényes értékek az (alapértelmezett) és a onoff. Szükséges --report-gh. |
--report-gh-annotations |
2.3.0 | Engedélyezi vagy letiltja a sikertelen és kihagyott tesztekhez tartozó széljegyzeteket. Az érvényes értékek az (alapértelmezett) és a onoff. Szükséges --report-gh. |
--report-gh-step-summary |
2.3.0 | Azt szabályozza, hogy a bővítmény egy Markdown-feladat összefoglalását írja-e a hivatkozott GITHUB_STEP_SUMMARYfájlba. Az érvényes értékek: on (alapértelmezett), off, valamint az MTP 2.4.0-tól kezdve on-failure. Szükséges --report-gh. |
--report-gh-step-summary-sections |
2.4.0 | Az összefoglaló tartalom kiválasztása. Az érvényes értékek a következők test-results: , slow-tests, coverageés all (alapértelmezett). Használatához off és a --report-gh módtól eltérő összegzési mód szükséges. |
--report-gh-failure-details |
2.4.0 | Engedélyezi vagy letiltja a korlátozott hibák részleteit a feladat összegzésében. Használja on (alapértelmezett) vagy off. A részletek közé tartoznak az üzenet, a kivétel típusa, a forrás helye és a veremkivonat, ha elérhető. Szükséges --report-gh. |
--report-gh-history |
2.4.0 | A megadott fájlelérési útvonalon beolvassa és frissíti a korlátozott helyi tesztelőzmények pillanatképét. A munkafolyamatnak le kell töltenie az előző pillanatképet a futtatás előtt, és később fel kell töltenie a frissített fájlt. Szükséges --report-gh. |
--report-gh-history-window |
2.4.0 | Beállítja a megőrzött előzményablakot 1 és 90 nap között. Az alapértelmezett érték 30 nap. Szükséges --report-gh-history. |
--report-gh-slow-test-notices |
2.3.0 | Engedélyezi vagy letiltja a lassú tesztelési értesítéseket. Az érvényes értékek az (alapértelmezett) és a onoff. Szükséges --report-gh. |
--report-gh-slow-test-threshold |
2.3.0 | A teszt futási időtartama a lassú tesztről szóló értesítés kibocsátása előtt. Elfogad egy önmagában megadott másodpercértéket, illetve egy mértékegység-utótaggal ellátott értéket, például 90s, 2m vagy 1.5h. Az alapértelmezett érték a 60s. Szükséges --report-gh. |
Az MTP 2.4.0-tól kezdve GitHub Actions Markdown-összegzések összesítik az eredményeket egy dotnet test meghívás minden tesztmoduljában. Ha a kódlefedettség is engedélyezve van, jelölje ki coverage vagy all adja meg a fedezeti és teljes számokat, százalékértékeket, küszöbérték-eredményeket, valamint egy mutatót, ha a lefedettségi adatok részlegesek.
A hiba részletei a korlátozott üzeneteken, a veremen, a hibaszámon és a teljes összegző költségvetésen belül maradnak. Ha a tartalom túllép egy korlátot, a jelentés csonkolja vagy tömöríti azt, és azt állítja, hogy az összegzés csökken.