Microsoft. A Testing.Platform (MTP) parancssori felületének beállításaira vonatkozó referencia

Ez a cikk egy központi belépési pontot biztosít az MTP parancssori beállításaihoz.

Important

A platformbeállítások az MTP-ből érhetők el. A bővítménybeállítások csak akkor érhetők el, ha minden célzott tesztalkalmazás regisztrálja az őket biztosító bővítménycsomagot. Adja hozzá közvetlenül a csomagot, vagy használjon egy teszt SDK-konfigurációt vagy profilt, amely tartalmazza azt. Ha egy tesztalkalmazás nem regisztrálja a bővítményt, a futtatás az 5-ös kilépési kóddal meghiúsul, mert a beállítás ismeretlen.

Platformbeállítások

  • @

    Megadja a válaszfájl nevét. A válaszfájl nevének közvetlenül követnie kell a @ karaktert, nem lehet szóköz a @ karakter és a válaszfájl neve között.

    A válaszfájl beállításai úgy vannak értelmezve, mintha a parancssor ezen a helyén lennének. A fordított perjel karakter \ nem használható vonalak összefűzésére. A válaszfájl használata nagyon hosszú parancsok esetén segít, amelyek túlléphetik a terminálkorlátokat. A válaszfájlokat beágyazott parancssori argumentumokkal kombinálhatja. Például:

    ./TestExecutable.exe @"filter.rsp" --timeout 10s

    ahol filter.rsp a következő tartalommal rendelkezhet:

    --filter "A very long filter"

    Vagy egyetlen rsp-fájl is használható az időtúllépés és a szűrés megadásához az alábbiak szerint:

    ./TestExecutable.exe @"arguments.rsp"

    --filter "A very long filter" --timeout 10s

    Megjegyzés:

    Használata esetén dotnet test az SDK parancssori elemzője egy token-per-line megközelítést használ, ahol a válaszfájl minden sorát egyetlen tokenként kezeli az SDK parancssori elemző. Ebben az esetben minden argumentumnak külön sorban kell lennie:

    --filter
A very long filter
--timeout
10s

  • --config-file

    Egy testconfig.json fájlt ad meg.

  • --debug

    Indításkor szünetelteti a teszt végrehajtását, hogy hibakeresőt csatoljon a tesztelési folyamathoz. Egyenértékű a TESTINGPLATFORM_WAIT_ATTACH_DEBUGGER beállításával1. Böngészőplatformokon nem támogatott.

    Megjegyzés:

    Ez a lehetőség az MTP-ben érhető el az 1.9.0-s verziótól kezdve. Az előző --debug-wait-attach (az MTP 1.6.0-s verzióban bevezetett) lehetőséget váltja fel; a régi név el lett távolítva, és többé nem használható.

  • --diagnostic

    Engedélyezi a diagnosztikai naplózást. Az alapértelmezett naplószint a(z) Trace. Minden tesztforráshoz az MTP írja a következőt <asm>_<tfm>_<arch>_<timestamp>.diag: . Ha időbélyeg-ütközés történik, az MTP a meglévő fájl felülírása helyett folyamat- és számlálóutótagot ad hozzá.

  • --diagnostic-synchronous-write

    A beépített fájlnaplózót kényszeríti a naplók szinkronizálására. Olyan helyzetekben hasznos, amikor nem szeretné elveszíteni a naplóbejegyzéseket (ha a folyamat összeomlik). Ez lelassítja a teszt végrehajtását.

    Megjegyzés:

    Az MTP-ben a 2.0.0-s verziótól kezdve érhető el. Az előző --diagnostic-filelogger-synchronouswrite lehetőséget váltja fel, amely az MTP 2.0.0-s verzióban lett eltávolítva.

  • --diagnostic-output-directory

    A diagnosztikai naplózás kimeneti könyvtára, ha nincs megadva, a fájl az alapértelmezett TestResults könyvtárban jön létre.

  • --diagnostic-file-prefix

    A naplófájl nevének előtagja. Az alapértelmezett érték a <asm>_<tfm>_<arch>.

    Megjegyzés:

    Az MTP-ben a 2.0.0-s verziótól kezdve érhető el. Az előző --diagnostic-output-fileprefix lehetőséget váltja fel, amely az MTP 2.0.0-s verzióban lett eltávolítva.

  • --diagnostic-verbosity

    Meghatározza a bőbeszédűség szintjét, amikor a --diagnostic kapcsoló használatban van. Az elérhető értékek a következők: Trace, Debug, Information, Warning, Errorvagy Critical.

  • --enable-dynamic-extensions

    Lehetővé teszi a tesztalkalmazás mellett található *.testingplatformextensions.json jegyzékfájlok által deklarált bővítmények betöltését. A dinamikus bővítmények alapértelmezés szerint le vannak tiltva. A biztonsági követelményekről és a jegyzéksémáról a bővítmények dinamikus betöltése című témakörben olvashat.

    Megjegyzés:

    Ez a lehetőség az MTP-ben érhető el a 2.4.0-s verziótól kezdve.

  • --exit-on-process-exit

    Ha a függő folyamat kilép, lépjen ki a tesztelési folyamatból. A PID-t meg kell adni.

  • --filter-uid

    A futtatandó teszteket a tesztcsomópontjaik UID-jei alapján szűri. Egy vagy több felhasználói azonosítót fogad el.

    Megjegyzés:

    Ez a lehetőség az MTP-ben érhető el az 1.8.0-s verziótól kezdve. Az MTP 2.3.0-s verziójától kezdve a(z) --filter-uid és a(z) --treenode-filter nem kombinálható; mindkettő megadása esetén a parancssori ellenőrzés meghiúsul a(z) InvalidCommandLine kilépési kóddal.

  • --help

    A parancs használatának leírását nyomtatja ki.

  • --ignore-exit-code

    Lehetővé teszi, hogy néhány nem nulla kilépési kód figyelmen kívül hagyható legyen, és ehelyett 0visszaadva. További információ: Adott kilépési kódok figyelmen kívül hagyása.

  • --info

    Speciális információkat jelenít meg a .NET tesztalkalmazásról, például:

    • A platform.
    • A környezet.
    • Minden regisztrált parancssori szolgáltató, például a name, version, descriptionés options.
    • Minden regisztrált eszköz, például a command, name, version, description, és minden parancssori szolgáltató.

    Ezzel a funkcióval megismerheti azokat a bővítményeket, amelyek ugyanazt a parancssori beállítást regisztrálnák, vagy a bővítmény (vagy a platform) több verziója között elérhető lehetőségek változásait.

  • --list-tests

    Megjeleníti az elérhető teszteket anélkül, hogy végrehajtanák őket. Igény szerint a kimeneti formátumot vezérlő argumentumot is használ: text (alapértelmezett, emberileg olvasható) vagy json.

    Megjegyzés:

    A json kimeneti formátum az MTP-ben érhető el a 2.3.0-s verziótól kezdve.

  • --maximum-failed-tests

    Meghatározza a maximális teszthibák számát, amely elérésekor a tesztfuttatás leáll. Ennek a kapcsolónak a támogatásához a keretrendszer-szerzőknek implementálniuk kell a IGracefulStopTestExecutionCapability képességet. A teszthibák mennyiségének elérésekor a kilépési kód 13. További információ: MTP kilépési kódok.

    Megjegyzés:

    Ez a funkció az MTP-ben érhető el az 1.5-ös verziótól kezdve.

  • --minimum-expected-tests

    Meghatározza a futtatandó tesztek minimális számát. Ha a futtatás kevesebb tesztet hajt végre — akár egyet sem —, 9 kóddal lép ki. A kifejezetten megadott minimum felülírja a(z) --zero-tests-policy értéket.

  • --no-banner

    Letiltja az indítási szalagcímet, a szerzői jogi üzenetet és a telemetriai szalagcímet. Ugyanez a hatás a TESTINGPLATFORM_NOBANNERDOTNET_NOLOGO keresztül érhető el.

  • --results-directory

    A könyvtár, ahova a teszteredményeket el fogják helyezni. Ha a megadott könyvtár nem létezik, az létrehozásra kerül. Az alapértelmezett TestResults a tesztalkalmazást tartalmazó könyvtárban.

  • --server

    A tesztalkalmazást JSON-RPC kiszolgálói módban indítja el a szerkesztői, IDE- vagy eszközintegrációhoz. Hagyja ki az értéket, vagy használja jsonrpc. Támogatott csak forráskódú ügyfél esetén lásd: MTP-kiszolgáló mód.

    Important

    Az dotnettestcli érték és átviteli argumentumai a .NET SDK-integráción belül vannak. Ne adja át manuálisan.

  • --show-slowest-tests

    A terminál összegzésében a leglassabb tesztek kért számát jeleníti meg. Ha egy futtatás több tesztmodult tartalmaz, az MTP az egyes modulok leglassabb tesztjeit jelenti.

    Megjegyzés:

    Ez a lehetőség az MTP-ben érhető el a 2.4.0-s verziótól kezdve.

  • --timeout

    A globális teszt végrehajtásának időtúllépése. Egy argumentumot sztringként használ a <value>[h|m|s] formátumban, ahol a <value> egy lebegőpontos szám.

  • --treenode-filter

    Szűri a futtatandó teszteket egy faszűrő kifejezés használatával. A faszűrők gazdagabb egyezést kínálnak, mint --filter a speciális forgatókönyvek esetében.

    Megjegyzés:

    Az MTP 2.3.0-s verziójától kezdve a(z) --treenode-filter és a(z) --filter-uid nem kombinálható; mindkettő megadása esetén a parancssori ellenőrzés meghiúsul a(z) InvalidCommandLine kilépési kóddal.

  • --zero-tests-policy

    Azt szabályozza, hogy egy olyan futtatás, amely nem hajt végre teszteket, mert minden teszt kimaradt, hibaként lesz-e kezelve. Az érvényes értékek az (alapértelmezett) és a allow-skippedstrict. A(z) allow-skipped használatával egy csupa kihagyásból álló futtatás sikeresnek minősül. A(z) strict használatakor 8 kilépési kóddal meghiúsul. Egy explicit --minimum-expected-tests érték felülírja ezt a szabályzatot, és kilépési kódot 9 használ, ha a minimális érték nem teljesül.

    Megjegyzés:

    Ez a lehetőség a 2.3.0-s verziótól kezdve elérhető az MTP-ben.

Bővítménybeállítások forgatókönyv szerint

Az alábbi táblázat segítségével megtalálhatja az egyes bővítmények csomagját és beállításait. A teszt SDK-profilok közvetlen csomaghivatkozás helyett csomagokat is megadhatnak.

Scenario Szükséges összetevő Funkciódokumentáció
Kódlefedettség gyűjtése Microsoft.Testing.Extensions.CodeCoverage vagy coverlet.MTP Kódlefedettség
Összeomlási vagy lefagyásos memóriaképek gyűjtése Microsoft.Testing.Extensions.CrashDump vagy Microsoft.Testing.Extensions.HangDump Összeomlási és lefagyási memóriaképek
Tesztjelentések létrehozása A kijelölt formátum bővítménycsomagja, például Microsoft.Testing.Extensions.TrxReport Tesztjelentések
Terminálkimenet testreszabása MTP core (nincs további csomag) Terminálkimenet
Sikertelen tesztek újrapróbálkoztatása Microsoft.Testing.Extensions.Retry Újrapróbálkozás

Lehetőségek felfedezése a tesztalkalmazásban

Futtassa a tesztfuttatható fájlt a(z) --help kapcsolóval, vagy futtassa a(z) dotnet test --help elemet MTP módban az aktuális bővítménykészlethez elérhető beállítások megjelenítéséhez.

A regisztrált szolgáltatók és opciók fejlett diagnosztikájához futtassa a következőt: --info.

Lásd még

  • Last updated on