Microsoft.Testing.Platform (MTP) referenční informace k možnostem rozhraní příkazového řádku

Tento článek poskytuje centrální vstupní bod pro možnosti příkazového řádku MTP.

Možnosti platformy

  • @

    Určuje název souboru odpovědi. Název souboru odpovědi musí okamžitě následovat za znakem @ bez mezer mezi znakem @ a názvem souboru odpovědi.

    Možnosti v souboru odpovědi se interpretují tak, jako kdyby byly na daném místě na příkazovém řádku. Zpětné lomítko \ nelze použít ke zřetězení řádků. Použití souboru odpovědi pomáhá pro velmi dlouhé příkazy, které by mohly překročit limity terminálu. Soubor odpovědi můžete kombinovat s vloženými argumenty příkazového řádku. Například:

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

    kde filter.rsp může mít následující obsah:

    --filter "A very long filter"

    Nebo jeden soubor rsp lze použít k určení časového limitu i filtru následujícím způsobem:

    ./TestExecutable.exe @"arguments.rsp"

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

    Poznámka:

    Při použití analyzátoru dotnet testpříkazového řádku sady SDK používá metodu token-per-line, kde se každý řádek v souboru odpovědi považuje za jeden token. V takovém případě musí být každý argument na samostatném řádku:

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

  • --config-file

    Určuje soubor testconfig.json.

  • --debug

    Pozastaví provádění testu při spuštění, aby bylo možné k testovacímu procesu připojit ladicí program. Odpovídá nastavení TESTINGPLATFORM_WAIT_ATTACH_DEBUGGERproměnné prostředí na 1. Nepodporuje se na platformách prohlížeče.

    Poznámka:

    Tato možnost je dostupná v MTP od verze 1.9.0. Nahrazuje předchozí --debug-wait-attach možnost (zavedená v MTP 1.6.0); starý název byl odebrán a už se nesmí používat.

  • --diagnostic

    Povolí protokolování diagnostiky. Výchozí úroveň protokolu je Trace. Soubor je zapsán ve výstupním adresáři s následujícím formátem názvu, log_[MMddHHssfff].diag.

  • --diagnostic-synchronous-write

    Vynutí integrovaný nástroj pro záznam souborů, aby synchronně zapisoval protokoly. Užitečné ve scénářích, kdy nechcete ztratit žádné položky protokolu (pokud se proces chybově ukončí). Tím se zpomalí spuštění testu.

    Poznámka:

    K dispozici v MTP od verze 2.0.0. Nahrazuje předchozí --diagnostic-filelogger-synchronouswrite možnost, která byla odebrána v MTP 2.0.0.

  • --diagnostic-output-directory

    Výstupní adresář protokolování diagnostiky, pokud není zadaný, soubor se vygeneruje ve výchozím adresáři TestResults.

  • --diagnostic-file-prefix

    Předpona názvu souboru protokolu. Výchozí hodnota je "log".

    Poznámka:

    K dispozici v MTP od verze 2.0.0. Nahrazuje předchozí --diagnostic-output-fileprefix možnost, která byla odebrána v MTP 2.0.0.

  • --diagnostic-verbosity

    Definuje úroveň verbosity při použití přepínače --diagnostic. Dostupné hodnoty jsou Trace, Debug, Information, Warning, Errornebo Critical.

  • --exit-on-process-exit

    Ukončete testovací proces, pokud skončí závislý proces. Je nutné zadat PID.

  • --filter-uid

    Filtruje testy tak, aby běžely podle jejich identifikátorů uživatelského rozhraní testovacího uzlu. Přijímá jedno nebo více identifikátorů UID.

    Poznámka:

    Tato možnost je dostupná v MTP od verze 1.8.0.

  • --help

    Vytiskne popis použití příkazu.

  • --ignore-exit-code

    Umožňuje, aby některé nenulové ukončovací kódy byly ignorovány a místo toho se vrátí jako 0. Další informace naleznete v tématu Ignorovat konkrétní ukončovací kódy.

  • --info

    Zobrazí rozšířené informace o testovací aplikaci .NET, například:

    • Platforma.
    • Prostředí.
    • Každý zaregistrovaný poskytovatel příkazového řádku, například name, version, descriptiona options.
    • Každý registrovaný nástroj, například command, name, version, description a všechny poskytovatele příkazového řádku.

    Tato funkce slouží k pochopení rozšíření, která by registrovala stejnou možnost příkazového řádku nebo změny dostupných možností mezi několika verzemi rozšíření (nebo platformou).

  • --list-tests

    Zobrazí seznam dostupných testů bez jejich provedení. Volitelně má argument, který řídí výstupní formát: text (výchozí, čitelný člověk) nebo json.

    Poznámka:

    Výstupní json formát je k dispozici v MTP od verze 2.3.0.

  • --maximum-failed-tests

    Určuje maximální počet selhání testů, které po dosažení zastaví testovací běh. Podpora tohoto přepínače vyžaduje, aby autoři architektury implementovali funkci IGracefulStopTestExecutionCapability. Ukončovací kód při dosažení tohoto počtu neúspěšných testů je 13. Další informace najdete v tématu Ukončovací kódy MTP.

    Poznámka:

    Tato funkce je dostupná v MTP od verze 1.5.

  • --minimum-expected-tests

    Určuje minimální počet testů, které se mají spustit. Ve výchozím nastavení se očekává, že se spustí aspoň jeden test.

  • --no-banner

    Zakáže úvodní banner, zprávu o autorských právech a banner telemetrie. Stejného efektu lze dosáhnout pomocí TESTINGPLATFORM_NOBANNER nebo DOTNET_NOLOGOproměnných prostředí.

  • --results-directory

    Adresář, do kterého se umístí výsledky testu. Pokud zadaný adresář neexistuje, vytvoří se. Výchozí hodnota je TestResults v adresáři, který obsahuje testovací aplikaci.

  • --timeout

    Časový limit spuštění globálního testu. Vezme jeden argument jako řetězec ve formátu <value>[h|m|s], kde <value> je plovoucí.

  • --treenode-filter

    Filtruje testy určené ke spuštění pomocí výrazu stromového filtru. Filtry stromu nabízejí pro pokročilé scénáře pokročilejší možnosti porovnávání než --filter.

  • --zero-tests-policy

    Určuje, zda se běh, ve kterém se neprovedou žádné testy, protože všechny testy byly přeskočeny, považuje za selhání. Platné hodnoty jsou allow-skipped (výchozí) a strict. Při allow-skipped běh, v němž se vše přeskočí, proběhne úspěšně; při strict selže s ukončovacím kódem 8 (chování před verzí 2.3.0).

    Poznámka:

    Tato možnost je dostupná v MTP od verze 2.3.0.

Možnosti rozšíření podle scénáře

Pomocí následující tabulky můžete rychle najít možnosti rozšíření.

Scenario Dokumentace k funkcím
Sbírat pokrytí kódu Pokrytí kódu
Shromažďování výpisů stavu systému nebo zablokování Výpisy stavu při pádu a zaseknutí
Generování sestav testů (například TRX) Testovací zprávy
Přizpůsobení výstupu terminálu Výstup terminálu
Použití ovládacích prvků na úrovni hostování Opětovné načítání za provozu
Opakování neúspěšných testů Opakovat
Spouštění testů, které používají Microsoft Fakes Microsoft Fakes
Generování trasování a metrik OpenTelemetry OpenTelemetry

Zjišťování možností v testovací aplikaci

Spusťte svůj testovací spustitelný soubor s --help, abyste zobrazili možnosti dostupné pro vaši aktuální sadu rozšíření.

Pro pokročilou diagnostiku registrovaných poskytovatelů a možností spusťte příkaz .--info

Viz také

  • Last updated on