Тестовые проекты MTP создаются как исполняемые файлы, которые можно запускать (или отлаживать) напрямую. Нет дополнительных тестов, выполняемых в консоли или команде. Приложение завершает работу с ненулевым кодом выхода, если возникает ошибка, что типично для большинства исполняемых файлов. Дополнительные сведения о известных кодах выхода см. в разделе "Коды выхода MTP".
Публикация тестового проекта с помощью dotnet publish и непосредственный запуск приложения являются другим способом выполнения тестов. Например, выполнение команды ./Contoso.MyTests.exe. В некоторых сценариях также возможно использование dotnet build для создания исполняемого файла, но стоит учитывать крайние случаи, такие как Native AOT.
Используйте dotnet run
Команду dotnet run можно использовать для сборки и запуска вашего тестового проекта. Это самый простой, хотя иногда самый медленный способ выполнения тестов. Использование dotnet run является целесообразным при редактировании и выполнении тестов локально, так как это гарантирует, что тестовый проект перестраивается при необходимости.
dotnet run также будет автоматически находить проект в текущей папке.
dotnet run --project Contoso.MyTests
Дополнительные сведения о dotnet run, см. в dotnet run.
Используйте dotnet exec
Команда dotnet exec или dotnet используется для выполнения (или запуска) уже созданного тестового project, это альтернатива запуску приложения напрямую.
dotnet exec требует указания пути к DLL собранного тестового проекта.
dotnet exec Contoso.MyTests.dll
или
dotnet Contoso.MyTests.dll
Замечание
Предоставление пути к исполняемому файлу тестового проекта (*.exe) приводит к ошибке:
Error:
An assembly specified in the application dependencies manifest
(Contoso.MyTests.deps.json) has already been found but with a different
file extension:
package: 'Contoso.MyTests', version: '1.0.0'
path: 'Contoso.MyTests.dll'
previously found assembly: 'S:\t\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'
Дополнительные сведения о dotnet execсм. в разделе dotnet exec.
Используйте dotnet test
Начиная с пакета SDK .NET 10, dotnet test имеет выделенный режим MTP. Выберите MTP через global.json, или используйте переменную среды DOTNET_TEST_RUNNER в .NET 11 и более поздних версиях. Выделенный режим поддерживает проекты, решения, встроенные тестовые модули и дополнительные типы входных данных в более новых версиях пакета SDK.
dotnet test --test-modules Contoso.MyTests.dll
Информацию о выборе средства запуска и переходе из режима, совместимого с VSTest, см. в разделе «Тестирование с dotnet test».
Тесты MTP можно запускать (и отлаживать) в Visual Studio, они интегрируются с обозревателем тестов, а также могут выполняться непосредственно в качестве запускаемого проекта.
Запуск приложения с помощью Visual Studio
Тестовый проект MTP создается как исполняемый файл и может выполняться напрямую. При этом выполняются все тесты в заданном исполняемом файле, если фильтр не указан.
- Перейдите к тестовому проекту, который вы хотите запустить в Обозреватель решений, щелкните её правой кнопкой мыши и выберите Установить в качестве начального проекта.
- Выберите Отладка>Запуск без отладки (или используйте Ctrl+F5) для запуска выбранного тестового проекта.
Откроется окно консоли с выполнением и сводкой тестового запуска.
Отладка приложения непосредственно в Visual Studio
Тестовый проект MTP можно отладить напрямую. Чтобы выполнить отладку всех тестов в указанном исполняемом файле, если фильтр не указан:
- Перейдите к тестовому проекту, который вы хотите запустить в Обозреватель решений, щелкните её правой кнопкой мыши и выберите Установить в качестве начального проекта.
- Задайте точку останова в тесте, который вы хотите отлаживать.
- Перейдите к Debug>Start Debuging (или нажмите F5), чтобы выполнить отладку выбранного тестового project.
Все тесты выполняются до тех пор, пока не будет достигнута точка останова. Пошагово выполните ваш тест, чтобы его отладить. После завершения отладки приложение возобновляет выполнение всех оставшихся тестов, если вы не остановите его.
Использование обозревателя тестов
Чтобы запустить тест, перейдите в обозреватель тестов, выберите тест (или тесты) для запуска. Щелкните его правой кнопкой мыши и выберите Запустить. Аналогично отладке теста, выберите тест (или тесты) в обозревателе тестов, щелкните правой кнопкой мыши и выберите Отладка.
Замечание
Автоматическое обновление тестов без сборки проекта недоступно.
Расширение C# вместе с C# Dev Kit позволяет отлаживать и выполнять тесты в Visual Studio Code, а также добавляет интеграцию с обозревателем тестов Visual Studio Code.
Запуск приложения с помощью кода Visual Studio
Тестовый проект MTP создается как исполняемый файл и может выполняться напрямую. При этом выполняются все тесты в заданном исполняемом файле, если фильтр не указан.
- Перейдите в тестовый файл, для которого требуется выполнить тесты.
- Используйте Ctrl+F5 для запуска выбранного тестового проекта. Если у вас есть несколько проектов, всплывающее окно попросит вас выбрать один для запуска.
Откроется окно консоли с выполнением и сводкой тестового запуска.
Отладка приложения непосредственно в коде Visual Studio
Тестовый проект MTP создается как исполняемый файл и может выполняться напрямую. При этом выполняются все тесты в заданном исполняемом файле, если фильтр не указан.
- Перейдите в тестовый файл, для которого требуется выполнить тесты.
- Используйте F5 для отладки выбранного тестового project. Если у вас есть несколько проектов, всплывающее окно попросит вас выбрать один для запуска.
Подсказка
Существует несколько других способов запуска dotnet project с помощью C# DevKit, таких как запуск из solution explorer или создание соответствующих конфигураций запуска. Они указаны в документации Visual Studio Code.
По мере запуска project откроется вкладка выходных данных с выполнением и сводкой тестового запуска.
Использование обозревателя тестов
Чтобы запустить тест, перейдите в обозреватель тестов, выберите тест (или тесты) для запуска. Щелкните его правой кнопкой мыши и выберите Запустить. Аналогично отладке теста, выберите тест (или тесты) в обозревателе тестов, щелкните правой кнопкой мыши и выберите Отладка.
Замечание
Автоматическое обновление тестов без сборки проекта недоступно.
Чтобы запустить несколько тестовых проектов параллельно, вызовите dotnet test один раз для файла решения, а не добавляйте шаг конвейера для каждого тестового исполняемого файла. При добавлении тестового проекта MTP в решение та же команда включает его без изменения конвейера.
Запустите решение в Azure Pipelines
Используйте пакет SDK .NET 10 или более поздней версии и MTP 1.7 или более поздней версии. Все тестовые проекты в решении должны поддерживать MTP; Тестовые проекты только VSTest не поддерживаются в этом режиме. Для более ранних версий SDK см. Запуск проектов MTP в режиме VSTest.
В корневом global.json каталоге репозитория создайте файл со следующим содержимым. Если файл уже существует, добавьте раздел test и убедитесь, что в параметрах SDK выбрано .NET 10 или более поздняя версия.
{
"test": {
"runner": "Microsoft.Testing.Platform"
}
}
Для отчетов TRX каждый тестовый проект должен ссылаться на Microsoft.Testing.Extensions.TrxReport, напрямую или через конфигурацию тестового пакета SDK или профиль, который включает его. Дополнительные сведения см. Отчеты о тестировании Visual Studio (TRX).
Добавьте следующий azure-pipelines.yml файл в репозиторий. В примере предполагается, что Contoso.sln и global.json находятся в корневом каталоге репозитория. Замените Contoso.sln на относительный путь к репозиторию для вашего решения.
trigger:
- main
pool:
vmImage: ubuntu-latest
steps:
- task: UseDotNet@2
displayName: Install .NET SDK
inputs:
packageType: sdk
version: 10.0.x
- task: DotNetCoreCLI@2
displayName: Run solution tests
inputs:
command: test
projects: Contoso.sln
arguments: --configuration Release --max-parallel-test-modules 4
workingDirectory: $(Build.SourcesDirectory)
publishTestResults: true
DotNetCoreCLI@2 Задача вызывает dotnet test один раз для решения. Команда восстанавливает зависимости, собирает решение и выполняет его тестовые модули MTP параллельно. По умолчанию dotnet test запускает до Environment.ProcessorCount модулей одновременно. В примере используется --max-parallel-test-modules 4 для ограничения параллелизма до четырех модулей. Настройте ограничение в соответствии с ЦП, памятью и другими ресурсами агента.
Это важно
Выберите файл решения в projects, а не шаблон файла проекта, например **/*.csproj. Задача вызывает dotnet test отдельно для каждого соответствующего файла, один за другим. Однократный вызов решения позволяет dotnet test координировать параллельное выполнение во всех его тестовых проектах.
Параллелизм на уровне модуля отличается от параллельного выполнения тестов в модуле. Чтобы настроить параллельные тесты в сборке, используйте параметры тестового фреймворка. Сведения о MSTest см. в разделе ParallelizeAttribute.
С помощью publishTestResults: true задача добавляет --report-trx и --results-directory, и публикует отчеты на вкладке "Тесты " конвейера, даже если тесты завершаются сбоем. Ненулевой dotnet test код выхода также приводит к сбою задачи и конвейера.
Замечание
Для поддержки DotNetCoreCLI@2 MTP требуется задача версии 2.263.0 или более поздней. Сохраните global.json в рабочем каталоге задачи, чтобы и задача, и пакет SDK .NET выбирали MTP.
Запустите решение с помощью скрипта
Для версий задач без поддержки MTP или для управления командой CLI напрямую используйте скрипт и опубликуйте отчеты TRX в отдельном шаге. Применяются те же требования к .NET SDK, global.json и расширению TRX.
trigger:
- main
pool:
vmImage: ubuntu-latest
steps:
- task: UseDotNet@2
displayName: Install .NET SDK
inputs:
packageType: sdk
version: 10.0.x
- task: CmdLine@2
displayName: Run solution tests
inputs:
script: >-
dotnet test --solution Contoso.sln
--configuration Release
--max-parallel-test-modules 4
--results-directory "$(Agent.TempDirectory)"
--report-trx
workingDirectory: $(Build.SourcesDirectory)
- task: PublishTestResults@2
displayName: Publish test results
condition: succeededOrFailed()
inputs:
testResultsFormat: VSTest
testResultsFiles: '**/*.trx'
searchFolder: $(Agent.TempDirectory)
failTaskOnFailedTests: true
failTaskOnMissingResultsFile: true
Условие succeededOrFailed() публикует результаты после успешного или неудачного тестового выполнения. Ненулевой код завершения скрипта по-прежнему приводит к сбою конвейера. Чтобы избежать перезаписи отчетов в разных модулях, не присваивайте каждому модулю одно и то же имя файла TRX. Сведения о параметрах именования и изоляции см. в разделе Имена файлов отчетов.
Запуск одного тестового исполняемого файла
Для одного тестового проекта соберите или опубликуйте проект перед вызовом исполняемого файла напрямую:
- task: CmdLine@2
displayName: "Run Contoso.MyTests"
inputs:
script: '.\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'