Testberichte

Für diese Features müssen zusätzliche NuGet-Pakete installiert werden, wie in den einzelnen Abschnitten 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.

Visual Studio Testberichte (TRX)

Die Visual Studio Testergebnisdatei (oder TRX) ist das Standardformat für die Veröffentlichung von Testergebnissen. Für diese Erweiterung ist das NuGet-Paket "Microsoft.Testing.Extensions.TrxReport " erforderlich.

Manuelle Registrierung

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

Hinweis

Wenn Sie die manuelle Registrierung verwenden, registrieren Sie den TRX-Berichtsanbieter zuletzt. Die aktuelle Implementierung hängt von der Registrierungsreihenfolge ab, sodass durch die Registrierung nach allen anderen Erweiterungen sichergestellt wird, dass alle Testdaten erfasst werden.

Options

Option Description
--report-trx Generiert den TRX-Bericht.
--report-trx-filename Der Name des generierten TRX-Berichts. Der Standardname entspricht dem folgenden Format <UserName>_<MachineName>_<yyyy-MM-dd_HH_mm_ss.fffffff>.trx.

Der Bericht wird im Standardordner TestResults gespeichert, der über das --results-directory Befehlszeilenargument angegeben werden kann.

Azure DevOps Berichte

Azure DevOps Berichts-Plug-In verbessert die Testausführung für Entwickler, die ihren Code auf GitHub hosten, aber auf Azure DevOps Build-Agents aufbauen. Es fügt zusätzliche Informationen zu Fehlern hinzu, um Fehler direkt in GitHub PR anzuzeigen.

Fehlerannotation in der GitHub PR-Dateienansicht

Für diese Erweiterung ist das NuGet-Paket "Microsoft.Testing.Extensions.AzureDevOpsReport NuGet" erforderlich.

Manuelle Registrierung

var builder = await TestApplication.CreateBuilderAsync(args);
builder.TestHost.AddAzureDevOpsProvider();

Options

Option Description
--report-azdo Aktiviert den Azure DevOps Berichtsgenerator. Fehler und Warnungen werden in ein Format geschrieben, das Azure DevOps versteht.
--report-azdo-severity Schweregrad, der für gemeldete Ereignisse verwendet werden soll. Gültige Werte sind error (Standard) und warning.
--report-azdo-flaky-history Abfragen Azure DevOps Testergebnisverlauf für die letzten N Tage (1-90) und kommentieren gemeldete Fehler mit Flakiness-Kontext. Erfordert --report-azdo.
--report-azdo-demote-known-flaky Stuft Fehlschläge, die im Azure DevOps-Verlaufsfenster häufig genug instabil sind (der Standardschwellenwert beträgt 25 %), von Fehlern zu Warnungen herab. Erfordert --report-azdo und --report-azdo-flaky-history.
--report-azdo-quarantine-file Pfad zu einer Textdatei, die in Quarantäne befindliche Testnamen oder Globmuster auflistet. Abgleichsfehler werden als Warnungen gemeldet. Erfordert --report-azdo.
--report-azdo-upload-artifacts Lädt Testergebnisdateien hoch und/oder fügt Buildtags zu Azure DevOps hinzu. Gültige Werte sind off (Standard), tags-only, , filesund all.
--report-azdo-upload-artifact-include Schließt Dateien beim Azure-DevOps-Artefaktupload mithilfe von Glob-Mustern ein, die relativ zum Verzeichnis der Testergebnisse angegeben sind. Wird standardmäßig auf **/* festgelegt. Erfordert --report-azdo-upload-artifacts einen anderen Wert als off.
--report-azdo-upload-artifact-exclude Schließt Dateien aus dem Azure DevOps Artefaktupload mithilfe von Globmustern relativ zum Verzeichnis der Testergebnisse aus. Erfordert --report-azdo-upload-artifacts einen anderen Wert als off.
--report-azdo-upload-artifact-name Überschreibt den Namen des Azure DevOps-Artifactcontainers. Wird standardmäßig auf TestResults_{assemblyName}_{tfm} festgelegt. Erfordert --report-azdo-upload-artifacts einen anderen Wert als off.
--publish-azdo-test-results Veröffentlicht Testergebnisse live auf der Registerkarte Azure DevOps Tests.
--publish-azdo-run-name Legt einen benutzerdefinierten Azure DevOps Testausführungsnamen für die Livetestergebnisveröffentlichung fest. Erfordert --publish-azdo-test-results.

Hinweis

Die Azure DevOps Erweiterung wurde in MTP 1.9.0 stabil (--report-azdo und --report-azdo-severity). Alle anderen Optionen in der Tabelle – --report-azdo-flaky-history, , --report-azdo-demote-known-flaky, --report-azdo-quarantine-file, --report-azdo-upload-artifacts, --report-azdo-upload-artifact-include, --report-azdo-upload-artifact-exclude, --report-azdo-upload-artifact-name, und --publish-azdo-test-results--publish-azdo-run-name– sind ab Version 2.3.0 in MTP verfügbar.

Die Erweiterung erkennt automatisch, dass sie in einer CI-Umgebung (Continuous Integration) ausgeführt wird, indem sie die TF_BUILD Umgebungsvariable überprüft.

  • Last updated on