Diagnostik

Diese Erweiterungen erfassen während eines Testlaufs Diagnosedaten, sodass Sie Fehler im Nachhinein diagnostizieren können. Jede Erweiterung erfordert ein zusätzliches NuGet-Paket, wie in jedem Abschnitt beschrieben.

Tipp

Bei Verwendung von Microsoft.Testing.Platform.MSBuild (transitiv von MSTest, NUnit und xUnit runners eingeschlossen) werden diese Erweiterungen automatisch registriert, wenn Sie ihre NuGet-Pakete installieren – keine Codeänderungen erforderlich. Die in diesem Artikel angegebene manuelle Registrierung ist nur erforderlich, wenn Sie den automatisch generierten Einstiegspunkt durch Festlegen <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>deaktiviert haben.

Informationen zur Diagnose auf Prozessebene finden Sie in den zugehörigen Crash- und Hang Dumps-Erweiterungen , die Prozessabbilddateien sammeln, wenn der Testhost abstürzt oder abstürzt.

Videorekorder

Der Videorekorder zeichnet den Bildschirm auf, während Ihre Tests ausgeführt werden, und fügt die aufgenommenen Videos als Artefakte an die Testsitzung an. Die Aufzeichnung muss für jeden Lauf explizit aktiviert werden und wird von einem externen ffmpeg-Prozess gesteuert, der auf dem PATH verfügbar sein oder über einen explizit angegebenen Pfad festgelegt werden muss. Diese Erweiterung erfordert das Microsoft.Testing.Extensions.VideoRecorder-NuGet-Paket.

Note

Verfügbar in MTP ab Version 2.3.0. Diese Erweiterung ist experimentell, und die Optionen und das Ausgabeformat können sich in einer zukünftigen Version ändern.

Manuelle Registrierung

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

Options

Option MTP-Version Description
--capture-video 2.3.0 Aktiviert die Bildschirmaufzeichnung. Die optionale Wertsteuerung steuert die Aufbewahrung: on-failure (Standard) hält Filmmaterial nur für fehlerhafte Tests und always hält Filmmaterial für jeden Test.
--capture-video-source 2.3.0 Legt die Aufnahmequelle fest. Gültige Werte sind screen (Standard) und window. Erfordert --capture-video.
--capture-video-granularity 2.3.0 Legt fest, ob der Recorder ein Video pro Test oder ein kapiteliertes Video für den gesamten Lauf erzeugt. Gültige Werte sind test (Standard) und session. Erfordert --capture-video.
--capture-video-max-duration 2.3.0 Schränkt die Datenträgernutzung auf langen Läufen ein, indem ungefähr die letzten N Sekunden des Filmmaterials beibehalten werden. Der Wert ist eine positive ganze Zahl von Sekunden. Erfordert --capture-video.
--capture-video-chapters 2.3.0 Legt fest, ob Kapitelmarken dem Video pro Sitzung hinzugefügt werden. Gültige Werte sind on (Standard) und off. Erfordert --capture-video.
--capture-video-args 2.3.0 Übergibt zusätzliche Argumente an den zugrunde liegenden Recorder (ffmpeg). Erfordert --capture-video.