Testberichtserweiterungen

In diesem Artikel werden alle Microsoft.Testing.Platform-Erweiterungen aufgeführt und erläutert, die sich auf die Testberichtsfunktion beziehen.

Ein Testbericht ist eine Datei, die Informationen über die Ausführung und das Ergebnis der Tests enthält.

Visual Studio-Testberichte

Die Visual Studio-Testergebnisdatei (oder TRX) ist das Standardformat für die Veröffentlichung von Testergebnissen. Diese Erweiterung wird als Teil des Pakets "Microsoft.Testing.Extensions.TrxReport " ausgeliefert.

Die verfügbaren Optionen sind wie folgt:

Auswahlmöglichkeit	BESCHREIBUNG
--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>.trx.

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

Azure DevOps-Berichte

Das 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.

Die Erweiterung wird im Paket "Microsoft.Testing.Extensions.AzureDevOpsReport" ausgeliefert.

Die verfügbaren Optionen sind wie folgt:

Auswahlmöglichkeit	BESCHREIBUNG
--report-azdo	Aktivieren der Ausgabe von Fehler- und Warnmeldungen in CI-Builds.
--report-azdo-severity	Schweregrad, der für das gemeldete Ereignis verwendet werden soll. Optionen sind: error (Standard) und warning.

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

Bestimmen der zu meldenden Zeile

Um die richtige Zeile im Code hervorzuheben, in dem fehler aufgetreten ist, durchsucht das AzureDevOps-Berichts-Plug-In den Fehlerstapel nach einer Datei, die im aktuellen Repository vorhanden ist.

Gehen Sie wie folgt vor, um dies zu ermitteln:

• findet das Repository-Stammverzeichnis; dies erfolgt durch die Suche nach dem Verzeichnis .git, das dem Startort der Testanwendung am nächsten liegt, was durch AppContext.BaseDirectory bestimmt wird.
• findet die erste Zeile in der Stapelablaufverfolgung mit Dateispeicherort und -zeile (die Bibliothek muss Debugsymbole aufweisen).
• schließt alle Dateien aus, die mit Assert.cs enden, um Details Ihrer Assertionsimplementierungen oder Wrapper zu vermeiden.
• schließt alle Dateien aus, die nicht auf dem Datenträger vorhanden sind (in der Regel handelt es sich um Zeilen aus externen Bibliotheken, die Debugsymbole z. B. MSTest enthalten).

(Dies sind interne Details, die dazu dienen, das Debuggen des Verhaltens zu unterstützen und sich in Zukunft ändern.)