Dokumentation zum .NET Core CLI-Tool dotnet-test

Name

dotnet-test – Komponententests mit konfiguriertem Testläufer ausführen

Zusammenfassung

`dotnet test [--configuration]

[--output] [--build-base-path] [--framework] [--runtime]
[--no-build]
[--parentProcessId] [--port]  
[<project>]`

Beschreibung

Der Befehl dotnet test wird verwendet, um Unit-Tests für ein bestimmtes Projekt durchzuführen. Unit-Tests sind Klassenbibliotheksprojekte, die für die Verwendung mit dem Dotnet-Testläufer auf einem Unit-Test-Framework (z. B. NUnit oder xUnit) basieren.

Testprojekte müssen ein Testläuferattribut mithilfe des Knotens „testRunner“ in project.json angeben. Dieser Wert sollte den Namen des Unit-Testing-Frameworks enthalten.

Das folgende Beispiel project.json zeigt die erforderlichen Attribute:

{
  "version": "1.0.0-*",
  "buildOptions": {
    "debugType": "portable"
  },
  "dependencies": {
    "System.Runtime.Serialization.Primitives": "4.1.1",
    "xunit": "2.1.0",
    "dotnet-test-xunit": "1.0.0-rc2-192208-24"
  },
  "testRunner": "xunit",
  "frameworks": {
    "netcoreapp1.0": {
      "dependencies": {
        "Microsoft.NETCore.App": {
          "type": "platform",
          "version": "1.0.0"
        }
      },
      "imports": [
        "dotnet5.4",
        "portable-net451+win8"
      ]
    }
  }
}

dotnet test unterstützt zwei Ausführungsmodi:

Konsole: Im Konsolenmodus ist dotnet test vollständig Führen Sie jeden an ihn übergebenen Befehl aus und geben Sie die Ergebnisse aus. Jedes Mal, wenn Sie dotnet test aufrufen, ohne --port zu übergeben, wird es im Konsolenmodus ausgeführt, was wiederum dazu führt, dass der Runner im Konsolenmodus ausgeführt wird.

Designphase: Wird im Kontext anderer Tools verwendet, z. B. Editoren oder integrierte Entwicklungsumgebungen (IDEs). Weitere Dokumentation zu diesem Modus finden Sie unter dotnet-test-Protokoll.

Optionen

[Projekt]

Geben Sie den Pfad zum zu testenden Projekt an. Wenn es weggelassen wird, wird standardmäßig das aktuelle Verzeichnis verwendet.

-c, --configuration [Debug|Release]

wird zum Generieren der Konfiguration verwendet. Der Standardwert ist Release.

-o, --output [DIR]

Suchen Sie das Verzeichnis, in dem die Binärdatei ausgeführt wird.

-b, --build-base-path [DIR]

Verzeichnis für temporäre Ausgabe.

-f, --framework [FRAMEWORK]

Zeigen Sie das angegebene Framework der Testbinärdatei an.

-r, --runtime [RUNTIME_IDENTIFIER]

Zeigen Sie die angegebene Laufzeit für die Testbinärdatei an.

--no-build

Erstellen Sie das Testprojekt nicht, bevor Sie es ausführen.

--parentProcessId

Geben Sie die ID des Prozesses über IDEs (Integrated Development Environments) an. Wenn der übergeordnete Prozess bereits verarbeitet wurde, wird der Test beendet.

--port

Geben Sie die Portnummer an, um auf Verbindungen über IDEs (Integrated Development Environments) zu lauschen.

Beispiel

Dotnet-Test

Führen Sie den Test für das Projekt im aktuellen Verzeichnis aus.

dotnet test /projects/test1/project.json

Führen Sie den Test im test1-Projekt aus.