Megosztás a következőn keresztül:


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

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

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.

  • --diagnostic

    Engedélyezi a diagnosztikai naplózást. Az alapértelmezett naplószint a(z) Trace. A fájl a kimeneti könyvtárban van megírva a következő névformátummal, log_[MMddHHssfff].diag.

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

  • --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. Alapértelmezett érték: "log".

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

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

  • --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

    Az elérhető tesztek listája. A tesztek nem lesznek végrehajtva.

  • --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ó: Microsoft.Testing.Platform kilépési kódok.

    Megjegyzés:

    Ez a funkció a Microsoft.Testing.Platform 1.5-ös verziójától kezdve érhető el.

  • --minimum-expected-tests

    Meghatározza a várhatóan futtatandó tesztek minimális számát. Alapértelmezés szerint legalább egy teszt futtatása várható.

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

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

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

Az alábbi táblázat segítségével gyorsan megtalálhatja a bővítménybeállításokat.

Scenario Funkciódokumentáció
Kódlefedettség gyűjtése Kódlefedettség
Összeomlási vagy lefagyásos memóriaképek gyűjtése Összeomlási és lefagyási memóriaképek
Tesztjelentések létrehozása (például TRX) Tesztjelentések
Terminálkimenet testreszabása Terminálkimenet
Üzemeltetési szintű vezérlők alkalmazása Hot Reload
Sikertelen tesztek újrapróbálkoztatása Újrapróbálkozás
Microsoft Fakest használó tesztek futtatása Microsoft Fakes
OpenTelemetria-nyomkövetések és metrikák kibocsátása OpenTelemetria

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

Futtassa a futtatható --help tesztet az aktuális bővítménykészlethez elérhető beállítások listázásához.

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

Lásd még