dotnet vstest

Ten artykuł dotyczy: ✔️ .NET Core 3.1 SDK i nowsze wersje

Ważne

Polecenie dotnet vstest jest zastępowane przez dotnet testelement , który może teraz służyć do uruchamiania zestawów. Zobacz dotnet test.

Nazwa

dotnet vstest — Uruchamia testy z określonych zestawów.

Streszczenie

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

Opis

Polecenie dotnet vstest uruchamia aplikację VSTest.Console wiersza polecenia w celu uruchomienia zautomatyzowanych testów jednostkowych.

Argumenty

  • TEST_FILE_NAMES

    Uruchamianie testów z określonych zestawów. Oddziel wiele nazw zestawów testowych spacjami. Obsługiwane są symbole wieloznaczne.

Opcje

  • --Blame

    Uruchamia testy w trybie winy. Ta opcja jest przydatna w izolowaniu problematycznych testów powodujących awarię hosta testowego. Tworzy plik wyjściowy w bieżącym katalogu jako Sequence.xml , który przechwytuje kolejność wykonywania testów przed awarią.

  • --Diag <PATH_TO_LOG_FILE>

    Włącza pełne dzienniki dla platformy testowej. Dzienniki są zapisywane w podanym pliku.

  • --Framework <FRAMEWORK>

    Docelowa wersja .NET Framework używana do wykonywania testów. Przykłady prawidłowych wartości to .NETFramework,Version=v4.6 lub .NETCoreApp,Version=v1.0. Inne obsługiwane wartości to Framework40, Framework45, FrameworkCore10i FrameworkUap10.

  • --InIsolation

    Uruchamia testy w izolowanym procesie. Dzięki temu vstest.console.exeproces jest mniej prawdopodobny, że zostanie zatrzymany po błędzie w testach, ale testy mogą działać wolniej.

  • -lt|--ListTests <FILE_NAME>

    Wyświetla listę wszystkich odnalezionych testów z danego kontenera testowego.

  • --logger <LOGGER_URI/FRIENDLY_NAME>

    Określ rejestrator dla wyników testów.

    • Aby opublikować wyniki testów na serwerze Team Foundation Server, użyj dostawcy rejestratora TfsPublisher :

      /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>]
      
    • Aby zarejestrować wyniki w pliku wyników testów programu Visual Studio (TRX), użyj dostawcy rejestratora trx . Ten przełącznik tworzy plik w katalogu wyników testów o podanej nazwie pliku dziennika. Jeśli LogFileName nie zostanie podana, zostanie utworzona unikatowa nazwa pliku do przechowywania wyników testu.

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

    Równoległe uruchamianie testów. Domyślnie wszystkie dostępne rdzenie na maszynie są dostępne do użycia. Określ jawną liczbę rdzeni, ustawiając MaxCpuCount właściwość w RunConfiguration węźle w pliku runsettings .

  • --ParentProcessId <PROCESS_ID>

    Identyfikator procesu nadrzędnego odpowiedzialnego za uruchomienie bieżącego procesu.

  • --Platform <PLATFORM_TYPE>

    Docelowa architektura platformy używana do wykonywania testów. Prawidłowe wartości to x86, x64i ARM.

  • --Port <PORT>

    Określa port połączenia gniazda i odbierania komunikatów o zdarzeniach.

  • --ResultsDirectory:<PATH>

    Katalog wyników testów zostanie utworzony w określonej ścieżce, jeśli nie istnieje.

  • --Settings <SETTINGS_FILE>

    Ustawienia do użycia podczas uruchamiania testów.

  • --TestAdapterPath <PATH>

    Użyj niestandardowych kart testowych z danej ścieżki (jeśli istnieje) w przebiegu testu.

  • --TestCaseFilter <EXPRESSION>

    Uruchom testy zgodne z danym wyrażeniem. <EXPRESSION> ma format <property>Operator<value>[|&<EXPRESSION>], gdzie Operator jest jednym z =, !=lub ~. Operator ~ ma semantykę "contains" i ma zastosowanie do właściwości ciągu, takich jak DisplayName. Nawiasy () są używane do grupowania podwyrażeń. Aby uzyskać więcej informacji, zobacz Filtr TestCase.

  • --Tests <TEST_NAMES>

    Uruchom testy z nazwami odpowiadającymi podanym wartościom. Użyj przecinków, aby oddzielić wiele wartości.

  • -?|--Help

    Drukuje krótką pomoc dotyczącą polecenia.

  • @<file>

    Odczytuje plik odpowiedzi, aby uzyskać więcej opcji.

  • args

    Określa dodatkowe argumenty, które mają być przekazywane do karty. Argumenty są określane jako pary nazwa-wartość formularza <n>=<v>, gdzie <n> jest nazwą argumentu i <v> jest wartością argumentu. Użyj spacji, aby oddzielić wiele argumentów.

Przykłady

Uruchom testy w mytestproject.dll:

dotnet vstest mytestproject.dll

Uruchom testy w mytestproject.dll, eksportuj do folderu niestandardowego o nazwie niestandardowej:

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

Uruchom testy w mytestproject.dll i myothertestproject.exe:

dotnet vstest mytestproject.dll myothertestproject.exe

Uruchamianie TestMethod1 testów:

dotnet vstest /Tests:TestMethod1

Uruchamianie TestMethod1 i TestMethod2 testy:

dotnet vstest /Tests:TestMethod1,TestMethod2

Zobacz też