Бөлісу құралы:


dotnet vstest

Эта статья относится к: ✔️ пакету SDK для .NET 6 и более поздних версий

Это важно

Команда dotnet vstest заменена dotnet test, которая теперь может использоваться для запуска сборок. См. тест dotnet.

Имя

dotnet vstest — выполняет тесты из указанных сборок.

Synopsis

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

Команда dotnet vstest запускает приложение командной VSTest.Console строки для запуска автоматизированных модульных тестов.

Arguments

  • TEST_FILE_NAMES

    Запустите тесты из указанных сборок. Разделите несколько имен тестовых сборок пробелами. Поддерживаются подстановочные знаки.

Options

  • --Blame

    Выполнение тестов в режиме обвинения. Этот параметр полезен при изоляции проблемных тестов, что приводит к сбою узла тестирования. Он создает выходной файл в текущем каталоге как Sequence.xml , который фиксирует порядок выполнения тестов до сбоя.

  • --Diag <PATH_TO_LOG_FILE>

    Включает подробные журналы для тестовой платформы. Журналы записываются в предоставленный файл.

  • --Framework <FRAMEWORK>

    Целевая версия .NET Framework, используемая для тестового выполнения. Пример допустимого значения..NETFramework,Version=v7.0 Другие поддерживаемые значения: Framework40, FrameworkCore10Framework45и FrameworkUap10.

  • --InIsolation

    Выполняет тесты в изолированном процессе. Это делает vstest.console.exe процесс менее вероятным для остановки ошибки в тестах, но тесты могут выполняться медленнее.

  • -lt|--ListTests <FILE_NAME>

    Перечисляет все обнаруженные тесты из заданного контейнера тестов.

  • --logger <LOGGER_URI/FRIENDLY_NAME>

    Укажите средство ведения журнала для результатов теста.

    • Чтобы опубликовать результаты теста в Team Foundation Server, используйте 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>]
      
    • Чтобы записать результаты в файл результатов теста Visual Studio (TRX), используйте trx поставщик средства ведения журнала. Этот параметр создает файл в каталоге результатов теста с заданным именем файла журнала. Если LogFileName он не указан, создается уникальное имя файла для хранения результатов теста.

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

    Выполняйте тесты в параллельном режиме. По умолчанию все доступные ядра на компьютере доступны для использования. Укажите явное число ядер, задав MaxCpuCount свойство под RunConfiguration узлом в файле runsettings .

  • --ParentProcessId <PROCESS_ID>

    Идентификатор процесса родительского процесса, ответственного за запуск текущего процесса.

  • --Platform <PLATFORM_TYPE>

    Целевая архитектура платформы, используемая для выполнения теста. Допустимые значения: x86, x64и ARM.

  • --Port <PORT>

    Указывает порт для подключения сокета и получение сообщений о событии.

  • --ResultsDirectory:<PATH>

    Каталог результатов теста будет создан в указанном пути, если он не существует.

  • --Settings <SETTINGS_FILE>

    Параметры, используемые при выполнении тестов.

  • --TestAdapterPath <PATH>

    Используйте пользовательские адаптеры тестирования из заданного пути (если таковые есть) в тестовом запуске.

  • --TestCaseFilter <EXPRESSION>

    Выполните тесты, соответствующие заданному выражению. <EXPRESSION> имеет формат <property>Operator<value>[|&<EXPRESSION>], в котором оператор является одним из =, !=или ~. Оператор ~ имеет семантику "содержит" и применяется для строковых свойств, таких как DisplayName. Скобки используются для группирования вложенных () выражений. Дополнительные сведения см. в разделе "Фильтр TestCase".

  • --Tests <TEST_NAMES>

    Выполните тесты с именами, соответствующими указанным значениям. Значения следует разделять запятыми.

  • -?|--Help

    Выводит краткую справку по команде.

  • @<file>

    Считывает файл ответа для получения дополнительных параметров.

  • args

    Задает дополнительные аргументы, передаваемые адаптеру. Аргументы указываются как пары "имя-значение" формы <n>=<v>, где <n> имя аргумента и <v> является значением аргумента. Для разделения аргументов используйте пробел.

Примеры

Выполнение тестов в mytestproject.dll:

dotnet vstest mytestproject.dll

Выполните тесты в mytestproject.dll, экспорт в пользовательскую папку с пользовательским именем:

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

Выполнение тестов в mytestproject.dll и myothertestproject.exe:

dotnet vstest mytestproject.dll myothertestproject.exe

Выполнение TestMethod1 тестов:

dotnet vstest /Tests:TestMethod1

Запуск TestMethod1 и TestMethod2 тестирование:

dotnet vstest /Tests:TestMethod1,TestMethod2

См. также