dotnet vstest

Ten artykuł dotyczy: ✔️ zestaw .NET 6 SDK i nowsze wersje

Ważne

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

Name

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

Streszczenie

dotnet vstest [<TEST_FILE_NAMES>] [--Blame] [--Collect:<DATA_COLLECTOR_NAME>]
    [--Diag:<PATH_TO_LOG_FILE>] [-e|--Environment:<NAME="VALUE">]
    [--Framework:<FRAMEWORK>] [--InIsolation] [-lt|--ListTests:<FILE_NAME>]
    [--logger:<LOGGER_URI/FRIENDLY_NAME>] [--Parallel]
    [--Platform:<PLATFORM_TYPE>] [--ResultsDirectory:<PATH>]
    [--Settings:<SETTINGS_FILE>] [--TestAdapterPath:<PATH>]
    [--TestCaseFilter:<EXPRESSION>] [--Tests:<TEST_NAMES>] [[--] <args>...]

dotnet vstest -?|--Help

Description

Polecenie dotnet vstest uruchamia aplikację VSTest.Console wiersza polecenia, aby uruchamiać zautomatyzowane testy jednostkowe. Opcje w tym artykule są przekazywane do usługi vstest.console. Aby uzyskać pełną listę opcji wiersza polecenia, zobacz vstest.console.exe opcje wiersza polecenia.

Arguments

  • TEST_FILE_NAMES

    Uruchamianie testów z określonych zestawów. Rozdziel 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ą.

  • --Collect:<DATA_COLLECTOR_NAME>

    Włącza moduł zbierający dane na potrzeby przebiegu testu. Na przykład --Collect:"Code Coverage" zbiera pokrycie kodu za pomocą wbudowanego modułu zbierającego Visual Studio i --Collect:"XPlat Code Coverage" używa międzyplatformowego modułu zbierającego Coverlet. Aby uzyskać więcej informacji, zobacz Monitorowanie i analizowanie przebiegu testu.

  • --Diag:<PATH_TO_LOG_FILE>

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

  • -e|--Environment:<NAME="VALUE">

    Ustawia wartość zmiennej środowiskowej dla procesu hosta testowego. Tworzy zmienną, jeśli nie istnieje, zastępuje ją, jeśli tak. Użycie tej opcji wymusza uruchamianie testów w izolowanym procesie. Określ opcję wiele razy, aby ustawić wiele zmiennych.

  • --Framework:<FRAMEWORK>

    Docelowa wersja programu .NET Framework używana do wykonywania testów. Przykładem prawidłowej wartości jest .NETFramework,Version=v7.0. Inne obsługiwane wartości to Framework40, , Framework45FrameworkCore10i FrameworkUap10.

  • --InIsolation

    Uruchamia testy w izolowanym procesie. Dzięki temu vstest.console.exe proces jest mniej prawdopodobne, ż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 testów.

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

  • --Platform:<PLATFORM_TYPE>

    Docelowa architektura platformy używana do wykonywania testów. Prawidłowe wartości to x86, , x64, ARM64ARMPpc64leS390x, RiscV64, i .LoongArch64

  • --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> jest formatem <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, które pasują do podanych wartości. Rozdziel wiele wartości przecinkami.

  • -?|--Help

    Wyświetla krótką pomoc dla 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ąc 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 także

  • Last updated on