dotnet vstest

  • Článek

Tento článek se týká sady ✔️ .NET Core 3.1 SDK a novějších verzí.

Důležité

Příkaz dotnet vstest je nahrazen příkazem dotnet test, který se teď dá použít ke spouštění sestavení. Viz dotnet test.

Name

dotnet vstest – Spustí testy ze zadaných sestavení.

Synopse

dotnet vstest [<TEST_FILE_NAMES>] [--Blame] [--Diag <PATH_TO_LOG_FILE>]
    [--Framework <FRAMEWORK>] [--InIsolation] [-lt|--ListTests <FILE_NAME>]
    [--logger <LOGGER_URI/FRIENDLY_NAME>] [--Parallel]
    [--ParentProcessId <PROCESS_ID>] [--Platform] <PLATFORM_TYPE>
    [--Port <PORT>] [--ResultsDirectory<PATH>] [--Settings <SETTINGS_FILE>]
    [--TestAdapterPath <PATH>] [--TestCaseFilter <EXPRESSION>]
    [--Tests <TEST_NAMES>] [[--] <args>...]]

dotnet vstest -?|--Help

Description

Příkaz dotnet vstest spustí aplikaci příkazového VSTest.Console řádku ke spuštění automatizovaných testů jednotek.

Argumenty

  • TEST_FILE_NAMES

    Spusťte testy ze zadaných sestavení. Více názvů testovacích sestavení oddělte mezerami. Zástupné cardy jsou podporované.

Možnosti

  • --Blame

    Spustí testy v režimu blame. Tato možnost je užitečná při izolování problematických testů, které způsobují chybové ukončení testovacího hostitele. Vytvoří výstupní soubor v aktuálním adresáři jako Sequence.xml , který zachycuje pořadí provádění testů před chybou.

  • --Diag <PATH_TO_LOG_FILE>

    Povolí podrobné protokoly pro testovací platformu. Protokoly se zapisují do zadaného souboru.

  • --Framework <FRAMEWORK>

    Cílová verze rozhraní .NET Framework používaná ke spuštění testu. Příklady platných hodnot jsou .NETFramework,Version=v4.6 nebo .NETCoreApp,Version=v1.0. Další podporované hodnoty jsou Framework40, Framework45, FrameworkCore10a FrameworkUap10.

  • --InIsolation

    Spustí testy v izolovaném procesu. Díky tomu je méně pravděpodobné, že se procesvstest.console.exe zastaví při chybě v testech, ale testy můžou běžet pomaleji.

  • -lt|--ListTests <FILE_NAME>

    Zobrazí seznam všech zjištěných testů z daného testovacího kontejneru.

  • --logger <LOGGER_URI/FRIENDLY_NAME>

    Zadejte protokolovací zařízení pro výsledky testu.

    • Pokud chcete publikovat výsledky testů na Team Foundation Server, použijte zprostředkovatele TfsPublisher protokolovacího nástroje:

      /logger:TfsPublisher;
    Collection=<team project collection url>;
    BuildName=<build name>;
    TeamProject=<team project name>
    [;Platform=<Defaults to "Any CPU">]
    [;Flavor=<Defaults to "Debug">]
    [;RunTitle=<title>]

    • Pokud chcete protokolovat výsledky do souboru trx (Test Results File) sady Visual Studio, použijte zprostředkovatele trx protokolovacího nástroje. Tento přepínač vytvoří soubor v adresáři výsledků testů s daným názvem souboru protokolu. Pokud LogFileName není zadaný, vytvoří se jedinečný název souboru pro uložení výsledků testu.

      /logger:trx [;LogFileName=<Defaults to unique file name>]

  • --Parallel

    Spouštějte testy paralelně. Ve výchozím nastavení jsou k dispozici všechna dostupná jádra na počítači. Zadejte explicitní počet jader nastavením MaxCpuCount vlastnosti pod RunConfiguration uzlem v souboru runsettings .

  • --ParentProcessId <PROCESS_ID>

    ID nadřazeného procesu zodpovědného za spuštění aktuálního procesu

  • --Platform <PLATFORM_TYPE>

    Architektura cílové platformy používaná k provádění testů Platné hodnoty jsou x86, x64a ARM.

  • --Port <PORT>

    Určuje port pro připojení soketu a příjem zpráv událostí.

  • --ResultsDirectory:<PATH>

    Pokud adresář výsledků testu neexistuje, vytvoří se v zadané cestě.

  • --Settings <SETTINGS_FILE>

    Nastavení, která se mají použít při spouštění testů.

  • --TestAdapterPath <PATH>

    V testovacím běhu použijte vlastní adaptéry testů z dané cesty (pokud existuje).

  • --TestCaseFilter <EXPRESSION>

    Spusťte testy, které odpovídají danému výrazu. <EXPRESSION>je ve formátu <property>Operator<value>[|&<EXPRESSION>], kde Operátor je , =!=nebo ~. Operátor ~ má sémantiku "contains" a dá se použít pro vlastnosti řetězce, jako je DisplayName. Závorky () se používají k seskupení dílčích výrazů. Další informace najdete v tématu Filtr testovacího případu.

  • --Tests <TEST_NAMES>

    Spusťte testy s názvy, které odpovídají zadaným hodnotám. Více hodnot oddělte čárkami.

  • -?|--Help

    Zobrazí krátkou nápovědu k příkazu.

  • @<file>

    Načte soubor odpovědi, kde najdete další možnosti.

  • args

    Určuje další argumenty, které se mají předat adaptéru. Argumenty jsou určeny jako dvojice název-hodnota ve tvaru <n>=<v>, kde <n> je název argumentu a <v> je hodnota argumentu. K oddělení více argumentů použijte mezeru.

Příklady

Spouštění testů v mytestproject.dll:

dotnet vstest mytestproject.dll

Spusťte testy v mytestproject.dlla exportujte je do vlastní složky s vlastním názvem:

dotnet vstest mytestproject.dll --logger:"trx;LogFileName=custom_file_name.trx" --ResultsDirectory:custom/file/path

Spouštění testů v mytestproject.dll a myothertestproject.exe:

dotnet vstest mytestproject.dll myothertestproject.exe

Spouštění TestMethod1 testů:

dotnet vstest /Tests:TestMethod1

Spuštění TestMethod1 a TestMethod2 testy:

dotnet vstest /Tests:TestMethod1,TestMethod2

Viz také