Функции Microsoft.Testing.Platform (MTP)

MTP поставляется со встроенными функциями и может быть расширен с помощью пакетов NuGet.

При использовании Microsoft.Testing.Platform.MSBuild (включаемый транзитивно MSTest, NUnit и xUnit runners), требуется только установка пакета расширения NuGet – расширения автоматически обнаруживаются и регистрируются, а точка входа создаётся автоматически.

Если вы откажетесь от автоматической точки входа, задав параметр <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>, необходимо зарегистрировать расширения вручную в методе Main . Каждая страница расширения документирует ручной вызов регистрации.

Расширения, для которых требуется пакет NuGet, поставляются с собственной моделью лицензирования (немного менее разрешительной), обязательно обратитесь к лицензии, связанной с расширениями, которые вы хотите использовать.

Некоторые расширения являются экспериментальнымиTPEXP: их API-интерфейсы помечены диагностикой и могут измениться в будущем выпуске, поэтому необходимо подтвердить диагностику для их использования. Экспериментальные расширения помечены (экспериментальные) в следующих списках.

Начните здесь

Используйте следующий путь в зависимости от вашей цели.

• Найдите параметры командной строки в одном месте: справочник по параметрам интерфейса командной строки MTP.
• Добавьте функциональные возможности в тестовые запуски: используйте страницы функций в этой статье.
• Создайте собственное расширение: архитектура MTP, точки расширения и службы.

Выбор по сценарию

• Необходимо настроить терминал: выходные данные терминала (встроенные).
• Требуются отчеты TRX или Azure DevOps: Test reports (расширение)
• Требуется собственный вывод GitHub Actions (группы логов, аннотации и сводка задания): отчёт GitHub Actions (расширение, экспериментальное)
• Требуются данные о покрытии: покрытие кода (расширение)
• Необходима диагностика сбоев или зависаний: дампы сбоев и зависаний (расширение)
• Нужно записать экран во время выполнения: Диагностика (расширение, экспериментальное)
• Необходимо развернуть и запустить тестовый хост для упакованного приложения: Развертывание тестового хоста (расширение, экспериментальное)
• Необходимо направлять журналы платформы через Microsoft.Extensions.Logging: интеграцию с Microsoft.Extensions (расширение, экспериментальная)
• Необходимо повторить неудачные тесты: повторная попытка (расширение)
• Требуется поддержка hot reload: Горячая перезагрузка (расширение)
• Нужна поддержка Microsoft Fakes: Microsoft Fakes (расширение)
• Требуется трассировка и метрики OpenTelemetry (расширение)
• Сбор данных телеметрии и возможность отказа от их использования: Телеметрия (расширение)

Встроенные функции

Эти функции являются частью основной платформы и не требуют дополнительных пакетов NuGet.

Выходные данные терминала

Отчеты о состоянии и ходе выполнения в терминале: режимы вывода, поддержка ANSI и индикаторы хода выполнения.

Функции расширения

Для этих функций требуется установка пакетов NuGet.

Тестовые отчеты

Создание файлов тестового отчета (TRX, HTML, JUnit, CTRF, Azure DevOps, GitHub Actions).

Покрытие кода

Сбор данных покрытия кода во время выполнения теста.

Аварийное завершение и зависание дампов

Сбор файлов дампа процесса при сбое или зависании тестового узла.

OpenTelemetry

Во время выполнения тестов трассировки и метрики передаются с помощью OpenTelemetry.

Повторить

Повторная проверка неудачных тестов с настраиваемыми политиками.

Горячая перезагрузка

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

Microsoft Fakes

Запустите тесты, использующие Microsoft Fakes для заглушек и шотов.

Телеметрии

Коллекция данных телеметрии. Узнайте, как отказаться от сбора данных и какие данные собираются.

Диагностика (экспериментальная, представленная в MTP 2.3.0)

Соберите данные для диагностики запуска, например записав экран с помощью средства видеозаписи.

Развертывание узла тестирования (экспериментальное, введенное в MTP 2.3.0)

Управление развертыванием и запуском тестового узла, например развертыванием и запуском тестового узла пакетного приложения.

Microsoft. Интеграция расширений (экспериментальная версия, представленная в MTP 2.3.0)

Интегрируйте данные диагностики платформы и расширений с библиотеками Microsoft.Extensions.*, которые уже использует ваше приложение, например, перенаправляя журналы через конвейер Microsoft.Extensions.Logging.