Diagnostyka

Te rozszerzenia przechwytują dowody podczas przebiegu testu, dzięki czemu można diagnozować błędy po fakcie. Każde rozszerzenie wymaga dodatkowego pakietu NuGet zgodnie z opisem w każdej sekcji.

Wskazówka

W przypadku korzystania z Microsoft.Testing.Platform.MSBuild (dołączonego tranzytywnie przez narzędzia uruchomieniowe MSTest, NUnit i xUnit), te rozszerzenia są automatycznie rejestrowane podczas instalowania pakietów NuGet — bez konieczności wprowadzania zmian w kodzie. Rejestracja ręczna określona w tym artykule jest wymagana tylko w przypadku wyłączenia automatycznie wygenerowanego punktu wejścia przez ustawienie<GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Aby uzyskać diagnostykę na poziomie procesu, zobacz powiązane rozszerzenia Zrzuty awarii i zawieszenia, które zbierają pliki zrzutu procesu, gdy host testowy ulegnie awarii lub zawiesi się.

Rejestrator wizyjny

Rejestrator wideo rejestruje ekran podczas działania testów i dołącza przechwycone nagrania wideo do sesji testowej jako artefakty. Rejestrowanie wymaga włączenia dla każdego uruchomienia i jest kontrolowane przez zewnętrzny proces ffmpeg, który musi być dostępny w PATH lub wskazany jawnie za pomocą ścieżki. To rozszerzenie wymaga pakietu NuGet Microsoft.Testing.Extensions.VideoRecorder.

Note

Dostępne w MTP począwszy od wersji 2.3.0. To rozszerzenie jest eksperymentalne, a jego opcje i format danych wyjściowych mogą ulec zmianie w przyszłej wersji.

Rejestracja ręczna

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddVideoRecorderProvider();

Opcje

Opcja Wersja MTP Description
--capture-video 2.3.0 Włącza nagrywanie ekranu. Opcjonalna wartość steruje przechowywaniem: on-failure (ustawienie domyślne) przechowuje nagrania tylko w przypadku testów zakończonych niepowodzeniem i always przechowuje nagrania na każdym teście.
--capture-video-source 2.3.0 Ustawia źródło przechwytywania. Prawidłowe wartości to screen (wartość domyślna) i window. Wymaga --capture-video.
--capture-video-granularity 2.3.0 Określa, czy rejestrator tworzy jedno nagranie na test, czy jedno nagranie z rozdziałami z całego przebiegu. Prawidłowe wartości to test (wartość domyślna) i session. Wymaga --capture-video.
--capture-video-max-duration 2.3.0 Ogranicza użycie miejsca na dysku podczas długotrwałego działania, zachowując około ostatnich N sekund nagrania. Wartość to dodatnia liczba całkowita określająca liczbę sekund. Wymaga --capture-video.
--capture-video-chapters 2.3.0 Określa, czy zakładki rozdziałów są dodawane do wideo dla danej sesji. Prawidłowe wartości to on (wartość domyślna) i off. Wymaga --capture-video.
--capture-video-args 2.3.0 Przekazuje dodatkowe argumenty do bazowego rejestratora (ffmpeg). Wymaga --capture-video.