MTP-Testprojekte werden als ausführbare Dateien erstellt, die direkt ausgeführt (oder gedebuggt) werden können. Es gibt keine zusätzliche Testausführungskonsole und keinen zusätzlichen Befehl. Die App wird mit einem Nonzero-Exitcode beendet, wenn ein Fehler auftritt, der für die meisten ausführbaren Dateien typisch ist. Weitere Informationen zu den bekannten Exitcodes finden Sie unter MTP-Exitcodes.
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 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
Ab dem .NET 10 SDK dotnet test verfügt über einen dedizierten MTP-Modus. Wählen Sie MTP über global.jsonoder verwenden Sie die DOTNET_TEST_RUNNER Umgebungsvariable mit .NET 11 oder höher. Der dedizierte Modus unterstützt Projekte, Lösungen, integrierte Testmodule und zusätzliche Eingabetypen in neueren SDK-Versionen.
dotnet test --test-modules Contoso.MyTests.dll
Informationen zur Runner-Auswahl und zur Migration aus dem VSTest-kompatiblen Modus finden Sie in Testen mit dotnet test.
Die MTP-Tests können in Visual Studio ausgeführt (und gedebuggt) werden, sie sind in Test-Explorer integriert und können auch direkt als Startprojekt ausgeführt werden.
Ausführen der App mit Visual Studio
MTP-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 Projektmappen-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
MTP-Testprojekt kann direkt gedebuggt 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 Projektmappen-Explorer ausführen möchten, klicken Sie es mit der rechten Maustaste an, und wählen Sie Als Startprojekt festlegen aus.
- 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
MTP-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 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
MTP-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 bauen ist nicht verfügbar.
Um mehrere Testprojekte parallel auszuführen, rufen Sie dotnet test einmal für die Lösung auf, anstatt einen Pipelineschritt für jede ausführbare Testdatei hinzuzufügen. Wenn Sie der Lösung ein MTP-Testprojekt hinzufügen, enthält derselbe Befehl es ohne Pipelineänderung.
Eine Lösung in Azure Pipelines ausführen
Verwenden Sie das .NET 10 SDK oder neuer und MTP 1.7 oder neuer. Alle Testprojekte in der Lösung müssen MTP unterstützen; ausschließliche VSTest-Testprojekte werden in diesem Modus nicht unterstützt. Frühere SDK-Versionen finden Sie unter Ausführen von MTP-Projekten im VSTest-Modus.
Erstellen Sie im Repositorystamm eine global.json Datei mit dem folgenden Inhalt. Wenn die Datei bereits vorhanden ist, fügen Sie den test Abschnitt hinzu, und stellen Sie sicher, dass die SDK-Einstellungen auf .NET 10 oder höher festgelegt sind.
{
"test": {
"runner": "Microsoft.Testing.Platform"
}
}
Für TRX-Berichte muss jedes Testprojekt auf Microsoft.Testing.Extensions.TrxReport verweisen, entweder direkt oder über eine Test-SDK-Konfiguration oder ein Profil, das es enthält. Ausführliche Informationen finden Sie unter Visual Studio Testberichte (TRX).
Fügen Sie Ihrem Repository die folgende azure-pipelines.yml Datei hinzu. Im Beispiel wird davon ausgegangen, dass Contoso.sln und global.json sich im Repositorystamm befinden. Ersetzen Sie Contoso.sln durch den repositoryrelativen Pfad Ihrer Lösung.
trigger:
- main
pool:
vmImage: ubuntu-latest
steps:
- task: UseDotNet@2
displayName: Install .NET SDK
inputs:
packageType: sdk
version: 10.0.x
- task: DotNetCoreCLI@2
displayName: Run solution tests
inputs:
command: test
projects: Contoso.sln
arguments: --configuration Release --max-parallel-test-modules 4
workingDirectory: $(Build.SourcesDirectory)
publishTestResults: true
Die DotNetCoreCLI@2 Aufgabe ruft dotnet test einmal für die Lösung auf. Der Befehl stellt die Abhängigkeiten wieder her, erstellt die Projektmappe und führt seine MTP-Testmodule parallel aus.
dotnet test führt standardmäßig bis zu Environment.ProcessorCount Module gleichzeitig aus. Im Beispiel wird mit --max-parallel-test-modules 4 die Parallelität auf vier Module beschränkt. Passen Sie den Grenzwert so an, dass er zur CPU, zum Arbeitsspeicher und zu anderen Ressourcen Ihres Agents passt.
Von Bedeutung
Wählen Sie in projects eine Lösungsdatei aus, kein Projektdateimuster wie **/*.csproj. Die Aufgabe ruft dotnet test für jede übereinstimmene Datei einzeln nacheinander auf. Ein einzelner Lösungsaufruf ermöglicht dotnet test, die parallele Ausführung über seine Testprojekte hinweg zu koordinieren.
Parallelität auf Modulebene unterscheidet sich von der parallelen Ausführung von Tests innerhalb eines Moduls. Verwenden Sie die Einstellungen des Testframeworks, um parallele Tests in einer Assembly zu konfigurieren. Informationen zu MSTest finden Sie unter ParallelizeAttribute.
Mit publishTestResults: true fügt die Aufgabe und --report-trx hinzu und veröffentlicht die Berichte auf der Registerkarte --results-directory des Pipelineausführungs, auch wenn Tests fehlschlagen. Ein Exitcode ungleich null dotnet test führt ebenfalls zum Fehlschlagen der Aufgabe und der Pipeline.
Hinweis
MTP-Unterstützung in DotNetCoreCLI@2 erfordert Aufgabenversion 2.263.0 oder höher. Behalten Sie global.json im Arbeitsverzeichnis der Aufgabe bei, damit sowohl die Aufgabe als auch das .NET SDK MTP auswählen.
Ausführen einer Lösung mit einem Skript
Verwenden Sie für Aufgabenversionen ohne MTP-Unterstützung oder zum direkten Steuern des CLI-Befehls ein Skript, und veröffentlichen Sie die TRX-Berichte in einem separaten Schritt. Die gleichen .NET SDKglobal.json- und TRX-Erweiterungsanforderungen gelten.
trigger:
- main
pool:
vmImage: ubuntu-latest
steps:
- task: UseDotNet@2
displayName: Install .NET SDK
inputs:
packageType: sdk
version: 10.0.x
- task: CmdLine@2
displayName: Run solution tests
inputs:
script: >-
dotnet test --solution Contoso.sln
--configuration Release
--max-parallel-test-modules 4
--results-directory "$(Agent.TempDirectory)"
--report-trx
workingDirectory: $(Build.SourcesDirectory)
- task: PublishTestResults@2
displayName: Publish test results
condition: succeededOrFailed()
inputs:
testResultsFormat: VSTest
testResultsFiles: '**/*.trx'
searchFolder: $(Agent.TempDirectory)
failTaskOnFailedTests: true
failTaskOnMissingResultsFile: true
Die succeededOrFailed() Condition veröffentlicht Ergebnisse nach einer erfolgreichen oder fehlgeschlagenen Testausführung. Der Exit-Code des Skripts ungleich null lässt die Pipeline trotzdem fehlschlagen. Um Berichtsüberschreibungen über Module hinweg zu vermeiden, weisen Sie jedem Modul nicht denselben TRX-Dateinamen zu. Benennungs- und Isolationsoptionen finden Sie unter Dateinamen für Berichte.
Eine einzelne ausführbare Testdatei ausführen
Bei einem einzelnen Testprojekt erstellen oder veröffentlichen Sie das Projekt, bevor Sie die ausführbare Datei direkt aufrufen:
- task: CmdLine@2
displayName: "Run Contoso.MyTests"
inputs:
script: '.\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'