Tipp
Mithilfe der Befehlszeilenoption können Sie einen bestimmten --ignore-exit-code ignorieren.
Sie können auch Befehlszeilenoptionen festlegen, die für ein bestimmtes Testprojekt in der Projektdatei mit der TestingPlatformCommandLineArguments MSBuild-Eigenschaft gelten. Ein gängiger Anwendungsfall ist für Testprojekte mit ignorierten Tests, die normalerweise mit Exitcode 8 beendet werden (die Testsitzung hat null Tests ausgeführt). In diesem Szenario können Sie folgendes unter einer PropertyGroup in Ihrer Projektdatei hinzufügen:
<TestingPlatformCommandLineArguments>$(TestingPlatformCommandLineArguments) --ignore-exit-code 8</TestingPlatformCommandLineArguments>
Das Veröffentlichen des Testprojekts mithilfe von dotnet publish und das direkte Ausführen der App ist eine weitere Möglichkeit, Ihre Tests auszuführen. Führen Sie z. B. ./Contoso.MyTests.exe aus. In einigen Szenarien ist es auch praktikabel, dotnet build zur Erstellung der ausführbaren Datei zu verwenden, es kann jedoch auch Grenzfälle geben, z. B. Native AOT.
dotnet run verwenden
Der dotnet run-Befehl kann zum Erstellen und Ausführen des Testprojekts verwendet werden. Dies ist die einfachste, obwohl manchmal langsamste Möglichkeit, Ihre Tests auszuführen. Die Verwendung von dotnet run ist praktisch, wenn Sie Tests lokal bearbeiten und ausführen, da sichergestellt wird, dass das Testprojekt bei Bedarf neu erstellt wird.
dotnet run wird das Projekt auch automatisch im aktuellen Ordner finden.
dotnet run --project Contoso.MyTests
Weitere Informationen zu dotnet run finden Sie unter dotnet run.
dotnet exec verwenden
Der dotnet exec- oder dotnet-Befehl wird verwendet, um ein bereits erstelltes Testprojekt auszuführen (oder zu nutzen). Dies ist eine Alternative zum direkten Ausführen der Anwendung.
dotnet exec erfordert einen Pfad zur integrierten Testprojekt-DLL.
dotnet exec Contoso.MyTests.dll
oder
dotnet Contoso.MyTests.dll
Hinweis
Wenn Sie den Pfad zur ausführbaren Datei des Testprojekts (*.exe) angeben, tritt ein Fehler auf:
Error:
An assembly specified in the application dependencies manifest
(Contoso.MyTests.deps.json) has already been found but with a different
file extension:
package: 'Contoso.MyTests', version: '1.0.0'
path: 'Contoso.MyTests.dll'
previously found assembly: 'S:\t\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'
Weitere Informationen zu dotnet exec finden Sie unter dotnet exec.
dotnet test verwenden
Microsoft.Testing.Platform bietet eine Kompatibilitätsschicht für vstest.console.exe und dotnet test und stellt so sicher, dass Sie Ihre Tests wie zuvor ausführen können, während gleichzeitig ein neues Ausführungsszenario aktiviert wird.
dotnet test Contoso.MyTests.dll
Die Microsoft.Testing.Platform-Tests können in Visual Studio ausgeführt (und debuggt) werden. Sie sind in Test-Explorer integriert und können auch direkt als Startprojekt ausgeführt werden.
Ausführen der App mit Visual Studio
Microsoft.Testing.Platform-Testprojekte werden als ausführbare Dateien erstellt und können direkt ausgeführt werden. Dadurch werden alle Tests in der angegebenen ausführbaren Datei ausgeführt, es sei denn, ein Filter wird angewendet.
- Navigieren Sie zum Testprojekt, das Sie im Projektmappen-Explorer ausführen möchten, wählen Sie es mit der rechten Maustaste aus, und wählen Sie Als Startprojekt festlegen aus.
- Wählen Sie Debuggen>Start ohne Debugging aus (oder verwenden Sie STRG+F5), um das ausgewählte Testprojekt auszuführen.
Das Konsolenfenster zeigt die Ausführung und Zusammenfassung Ihres Testlaufs an.
Debuggen der App direkt in Visual Studio
Das Microsoft.Testing.Platform-Testprojekt kann direkt debuggt werden. So debuggen Sie alle Tests in der angegebenen ausführbaren Datei, es sei denn, ein Filter wird angewendet:
- Navigieren Sie zum Testprojekt, das Sie im Projektmappen-Explorer ausführen möchten, wählen Sie es mit der rechten Maustaste aus, und wählen Sie Als Startprojekt festlegen aus.
- Legen Sie den Breakpoint in dem Test fest, den Sie debuggen möchten.
- Wechseln Sie zu Debuggen>Debuggen starten (oder drücken Sie F5), um das ausgewählte Testprojekt zu debuggen.
Alle Tests werden ausgeführt, bis der Test mit dem Breakpoint erreicht wird. Führen Sie den Test schrittweise aus, um ihn zu debuggen. Nachdem Sie mit dem Debuggen der App fertig sind, werden alle verbleibenden Tests fortgesetzt, es sei denn, Sie beenden sie.
Verwenden des Test-Explorers
Um einen Test auszuführen, navigieren Sie zum Test-Explorer, wählen Sie den Test (oder die Tests) aus, der ausgeführt werden soll. Klicken Sie mit der rechten Maustaste darauf, und wählen Sie Ausführen aus. Ähnlich wie beim Debuggen eines Tests wählen Sie den Test (oder die Tests) im Test-Explorer aus, und klicken mit der rechten Maustaste auf Debuggen.
Hinweis
Die automatische Aktualisierung von Tests, ohne das Projekt zu erstellen, ist nicht verfügbar.
Mit der C#-Erweiterung und dem C# Dev Kit können Sie Tests in Visual Studio-Code debuggen/ausführen sowie die Integration mit dem Test-Explorer von Visual Studio Code hinzufügen.
Ausführen der App mit Visual Studio Code
Microsoft.Testing.Platform-Testprojekte werden als ausführbare Dateien erstellt und können direkt ausgeführt werden. Dadurch werden alle Tests in der angegebenen ausführbaren Datei ausgeführt, es sei denn, ein Filter wird angewendet.
- Navigieren Sie zu einer Testdatei, für die Sie Tests ausführen möchten.
- Verwenden Sie STRG+F5, um das ausgewählte Testprojekt auszuführen. Wenn Sie über mehrere Projekte verfügen, werden Sie aufgefordert, das auszuführende Projekt auszuwählen.
Das Konsolenfenster zeigt die Ausführung und Zusammenfassung Ihres Testlaufs an.
Debuggen der App direkt in Visual Studio Code
Microsoft.Testing.Platform-Testprojekte werden als ausführbare Dateien erstellt und können direkt ausgeführt werden. Dadurch werden alle Tests in der angegebenen ausführbaren Datei ausgeführt, es sei denn, ein Filter wird angewendet.
- Navigieren Sie zu einer Testdatei, für die Sie Tests ausführen möchten.
- Verwenden Sie F5, um das ausgewählte Testprojekt zu debuggen. Wenn Sie über mehrere Projekte verfügen, werden Sie aufgefordert, das auszuführende Projekt auszuwählen.
Tipp
Es gibt mehrere andere Möglichkeiten, ein Dotnet-Projekt mit C# DevKit auszuführen, z. B. das Ausführen über den Projektmappen-Explorer oder das Erstellen entsprechender Startkonfigurationen. Diese werden in der Visual Studio Code-Dokumentation angegeben.
Wenn das Projekt ausgeführt wird, erscheint das Ausgabefeld mit der Ausführung des Tests und der Zusammenfassung.
Verwenden des Test-Explorers
Um einen Test auszuführen, navigieren Sie zum Test-Explorer, wählen Sie den Test (oder die Tests) aus, der ausgeführt werden soll. Klicken Sie mit der rechten Maustaste darauf, und wählen Sie Ausführen aus. Ähnlich wie beim Debuggen eines Tests wählen Sie den Test (oder die Tests) im Test-Explorer aus, und klicken mit der rechten Maustaste auf Debuggen.
Hinweis
Die automatische Aktualisierung von Tests, ohne das Projekt zu erstellen, ist nicht verfügbar.
Um ein einzelnes Testprojekt in CI auszuführen, fügen Sie einen Schritt für jede ausführbare Testdatei hinzu, die Sie ausführen möchten, z. B. die folgenden in Azure DevOps:
- task: CmdLine@2
displayName: "Run Contoso.MyTests"
inputs:
script: '.\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'
Führen Sie den dotnet test Befehl manuell aus, ähnlich wie der typische lokale Workflow:
- task: CmdLine@2
displayName: "Run tests"
inputs:
script: 'dotnet test' # add command-line options as needed
Führen Sie die DotNetCoreCLI Azure-Aufgabe mit dem Testbefehl aus. Dies erfordert eine global.json Datei im Repositorystamm, die Microsoft.Testing.Platform als Testläufer angibt:
{
"test": {
"runner": "Microsoft.Testing.Platform"
}
}
- task: DotNetCoreCLI@2
displayName: "Run tests"
inputs:
command: test
Hinweis
Unterstützung für Microsoft.Testing.Platform in DotNetCoreCLI wurde in der Version 2.263.0 der Aufgabe hinzugefügt.