Tipp
Mithilfe der Befehlszeilenoption können Sie einen bestimmten --ignore-exit-code ignorieren.
Sie können auch Befehlszeilenoptionen festlegen, die für einen bestimmten Test project in der project-Datei gelten, indem Sie die Eigenschaft TestingPlatformCommandLineArguments MSBuild verwenden. 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 einem PropertyGroup in Ihrer project Datei hinzufügen:
<TestingPlatformCommandLineArguments>$(TestingPlatformCommandLineArguments) --ignore-exit-code 8</TestingPlatformCommandLineArguments>
Das Veröffentlichen des Test-project 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 Befehl dotnet run kann zum Erstellen und Ausführen des Test-project 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 der Test project bei Bedarf neu erstellt wird.
dotnet run findet das Projekt auch automatisch im aktuellen Ordner.
dotnet run --project Contoso.MyTests
Weitere Informationen zu dotnet run finden Sie unter dotnet run.
dotnet exec verwenden
Der Befehl dotnet exec oder dotnet wird verwendet, um ein bereits erstelltes Testprojekt zu starten, dies ist eine Alternative dazu, die Anwendung direkt zu starten.
dotnet exec erfordert den Pfad zur kompilierten Testprojekt-DLL.
dotnet exec Contoso.MyTests.dll
oder
dotnet Contoso.MyTests.dll
Hinweis
Bei Angabe des Pfades zur ausführbaren Projektdatei (*.exe) 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 debuggiert) werden, sie sind in Test-Explorer integriert und können auch direkt als Start-project 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 zu dem Testprojekt, das Sie in Solution Explorer ausführen möchten, klicken Sie es mit der rechten Maustaste an, und wählen Sie Als Startprojekt festlegen aus.
- Wählen Sie Debug>Start ohne Debugging aus (oder verwenden Sie Ctrl+F5) zum Ausführen des ausgewählten Test-project.
Das Konsolenfenster zeigt die Ausführung und Zusammenfassung Ihres Testlaufs an.
Debuggen der App direkt in Visual Studio
Microsoft.Testing.Platform Testprojekt kann direkt debuggen werden. So debuggen Sie alle Tests in der angegebenen ausführbaren Datei, es sei denn, ein Filter wird angewendet:
- Navigieren Sie zu dem Testprojekt, das Sie in Solution Explorer ausführen möchten, wählen Sie es mit der rechten Maustaste aus und wählen Sie dann Als Startprojekt festlegen.
- Legen Sie den Breakpoint in dem Test fest, den Sie debuggen möchten.
- Wechseln Sie zu Debug>Start Debugging (oder drücken Sie F5), um das ausgewählte Test-project 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
Automatische Aktualisierung von Tests ohne das Projekt zu bauen ist nicht verfügbar.
Die C#-Erweiterung zusammen mit C# Dev Kit ermöglicht das Debuggen und Ausführen von Tests in Visual Studio Code und bietet außerdem eine Integration mit dem Test Explorer von Visual Studio Code.
Ausführen der App mit Visual Studio Code
Microsoft.Testing.Platform Testprojekte werden als ausführbare Programme 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 Ctrl+F5, um den ausgewählten Test project 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 die ausgewählte Test-project 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 zum Ausführen eines dotnet-project mit C# DevKit, z. B. das Ausführen von solution explorer oder das Erstellen entsprechender Startkonfigurationen. Diese werden in der Visual Studio Codedokumentation angegeben.
Wenn das Projekt ausgeführt wird, öffnet sich der Ausgabe-Tab mit der Ausführung und Zusammenfassung Ihrer Testausführung.
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
Automatische Aktualisierung von Tests, ohne das Projekt zu erstellen, ist nicht verfügbar.
Um ein einzelnes Testprojekt in CI auszuführen, fügen Sie für jede Test-Executable, die Sie ausführen möchten, einen Schritt hinzu, wie folgt 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 Azure-Aufgabe DotNetCoreCLI mit dem Befehl testen 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 2.263.0 Version der Aufgabe hinzugefügt.