Freigeben über

Referenz der CLI-Optionen von Microsoft.Testing.Platform

Dieser Artikel enthält einen zentralen Einstiegspunkt für die Befehlszeilenoptionen von Microsoft.Testing.Platform.

Plattformoptionen

  • @

    Gibt den Namen der Antwortdatei an. Der Name der Antwortdatei muss dem `@`-Zeichen, ohne Leerzeichen zwischen dem `@`-Zeichen und dem Namen der Antwortdatei, direkt folgen.

    Optionen in einer Antwortdatei werden so interpretiert, als ob sie an dieser Stelle in der Befehlszeile vorhanden wären. Sie können das umgekehrte Schrägstrichzeichen \ nicht verwenden, um Linien zu verketten. Die Verwendung einer Antwortdatei ist bei sehr langen Befehlen hilfreich, die die Terminalgrenzen überschreiten können. Sie können eine Antwortdatei mit Inline-Befehlszeilenargumenten kombinieren. Beispiel:

    ./TestExecutable.exe @"filter.rsp" --timeout 10s

    wobei filter.rsp den folgenden Inhalt haben kann:

    --filter "A very long filter"

    Alternativ können Sie mit einer einzelnen RSP-Datei wie folgt sowohl Timeout als auch Filter angeben:

    ./TestExecutable.exe @"arguments.rsp"

    --filter "A very long filter" --timeout 10s

    Hinweis

    Bei Verwendung dotnet testdes SDK-Befehlszeilenparsers wird ein Token-pro-Line-Ansatz verwendet, bei dem jede Zeile in der Antwortdatei als einzelnes Token behandelt wird. In diesem Fall muss jedes Argument in einer separaten Zeile stehen:

    --filter
A very long filter
--timeout
10s

  • --config-file

    Gibt eine testconfig.json-Datei an.

  • --diagnostic

    Aktiviert die Diagnoseprotokollierung. Die Standardprotokollebene ist Trace. Die Datei wird im Ausgabeverzeichnis mit dem folgenden Namensformat geschrieben: log_[MMddHHssfff].diag.

  • --diagnostic-synchronous-write

    Zwingt den integrierten Dateilogger, Protokolle synchron zu schreiben. Nützlich für Szenarien, in denen keine Protokolleinträge verloren gehen sollen (bei Prozessabsturz). Dadurch wird die Testausführung verlangsamt.

  • --diagnostic-output-directory

    Das Ausgabeverzeichnis der Diagnoseprotokollierung. Wird es nicht angegeben, wird die Datei im Standardverzeichnis TestResults generiert.

  • --diagnostic-file-prefix

    Das Präfix für den Namen der Protokolldatei. Wird standardmäßig auf "log" festgelegt.

  • --diagnostic-verbosity

    Definiert den Ausführlichkeitsgrad, wenn die Option --diagnostic verwendet wird. Verfügbare Werte sind Trace, Debug, Information, Warning, Error oder Critical.

  • --exit-on-process-exit

    Beenden Sie den Testprozess, wenn ein abhängiger Prozess beendet wird. Die PID muss angegeben werden.

  • --help

    Gibt eine Beschreibung zur Verwendung des Befehls aus.

  • --ignore-exit-code

    Erlaubt, dass einige Nicht-Null-Exitcodes ignoriert werden und stattdessen als 0 zurückgegeben werden. Weitere Informationen finden Sie im Abschnitt Ignorieren spezifischer Exitcodes.

  • --info

    Zeigt erweiterte Informationen zur .NET-Testanwendung an, z. B.:

    • Die Plattform.
    • Zur Umgebung.
    • Jeder registrierte Kommandozeilenanbieter, wie z. B. name, version, description und options.
    • Jedes registrierte Tool, wie z. B. seine command, name, version, description und alle Kommandozeilen-Anbieter.

    Dieses Feature wird verwendet, um Erweiterungen zu verstehen, die dieselbe Befehlszeilenoption registrieren, oder um die Änderungen bei den verfügbaren Optionen zwischen mehreren Versionen einer Erweiterung (oder der Plattform) zu ermitteln.

  • --list-tests

    Auflisten verfügbarer Tests. Tests werden nicht ausgeführt.

  • --maximum-failed-tests

    Gibt die maximale Anzahl von Testfehlern an, bei deren Erreichen der Testlauf abgebrochen wird. Zur Unterstützung dieses Schalters müssen die Autoren des Frameworks die Funktionalität IGracefulStopTestExecutionCapability implementieren. Der Exit-Code bei Erreichen dieser Anzahl von Testfehlern ist 13. Weitere Informationen finden Sie unter Microsoft.Testing.Platform Exit-Codes.

    Hinweis

    Dieses Feature ist ab Version 1.5 in Microsoft.Testing.Platform verfügbar.

  • --minimum-expected-tests

    Gibt die Mindestanzahl der auszuführenden Tests an. Standardmäßig wird davon ausgegangen, dass mindestens ein Test ausgeführt wird.

  • --results-directory

    Das Verzeichnis, in dem die Testergebnisse gespeichert werden. Wenn das angegebene Verzeichnis noch nicht existiert, wird es erstellt. Der Standardwert ist TestResults im Verzeichnis, das die Testanwendung enthält.

  • --timeout

    Eine globale Zeitüberschreitung für die Testausführung. Nimmt ein Argument als Zeichenfolge im Format <value>[h|m|s] an, wobei <value> ein Float ist.

Erweiterungsoptionen nach Szenario

Verwenden Sie die folgende Tabelle, um Erweiterungsoptionen schnell zu finden.

Scenario Funktionsdokumentation
Erfassung der Code-Abdeckung Codeabdeckung
Sammeln von Absturz- oder Absturzabbildern Absturz- und Absturzabbilder
Generieren von Testberichten (z. B. TRX) Testberichte
Anpassen der Terminalausgabe Terminalausgabe
Anwenden von Steuerelementen auf Hostingebene Hot Reload
Wiederholen fehlgeschlagener Tests Wiederholen.
Ausführen von Tests, die Microsoft Fakes verwenden Microsoft Fakes
Senden von OpenTelemetry-Ablaufverfolgungen und Metriken OpenTelemetry

Entdecken von Optionen in Ihrer Test-App

Führen Sie Ihr ausführbares Testprogramm mit --help aus, um die verfügbaren Optionen für Ihr aktuelles Erweiterungsset aufzulisten.

Für eine erweiterte Diagnose von registrierten Anbietern und Optionen führen Sie --info aus.

Siehe auch

  • Last updated on