Sdílet prostřednictvím

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

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

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.

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

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

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

  • --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ů. Testy se nespustí.

  • --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 naleznete v tématu Kódy ukončení Microsoft.Testing.Platform.

    Poznámka:

    Tato funkce je dostupná na platformě Microsoft.Testing.Platform 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.

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

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í Hot Reload
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