Dokumentacja opcji CLI Microsoft.Testing.Platform

Ten artykuł zawiera centralny punkt wejścia dla opcji wiersza polecenia Microsoft.Testing.Platform.

Opcje platformy

• @

  Określa nazwę pliku odpowiedzi. Nazwa pliku odpowiedzi musi znajdować się bezpośrednio po znaku @ bez żadnej spacji między znakiem @ a nazwą pliku odpowiedzi.

  Opcje w pliku odpowiedzi są interpretowane tak, jakby były obecne w tym miejscu w wierszu polecenia. Nie można używać znaku \ ukośnika odwrotnego do łączenia wierszy. Użycie pliku odpowiedzi pomaga w przypadku bardzo długich poleceń, które mogą przekroczyć limity terminalu. Plik odpowiedzi można połączyć z wbudowanymi argumentami wiersza polecenia. Przykład:

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

  gdzie filter.rsp może zawierać następującą zawartość:

  --filter "A very long filter"
  

  Można też użyć pojedynczego pliku rsp do określenia limitu czasu i filtru w następujący sposób:

  ./TestExecutable.exe @"arguments.rsp"
  

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

  Uwaga / Notatka

  Podczas używania dotnet test, analizator wiersza polecenia w zestawie SDK stosuje podejście "token na linię", w którym każdy wiersz w pliku odpowiedzi jest traktowany jako pojedynczy token. W takim przypadku każdy argument musi znajdować się w osobnym wierszu:

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

• --config-file

  Określa plik testconfig.json.

• --diagnostic

  Włącza rejestrowanie diagnostyczne. Domyślny poziom logowania to Trace. Plik jest zapisywany w katalogu wyjściowym z następującym formatem nazwy, log_[MMddHHssfff].diag.

• --diagnostic-synchronous-write

  Wymusza synchroniczne zapisywanie logów przez wbudowany rejestrator plików. Przydatne w scenariuszach, w których nie chcesz utracić żadnych wpisów dziennika (jeśli proces ulegnie awarii). Spowalnia to wykonywanie testu.

• --diagnostic-output-directory

  Katalog wyjściowy dla rejestrowania diagnostycznego; jeśli katalog nie został określony, plik jest generowany w domyślnym katalogu TestResults.

• --diagnostic-file-prefix

  Prefiks nazwy pliku dziennika. Wartość domyślna to "log".

• --diagnostic-verbosity

  Definiuje poziom szczegółowości, gdy używany jest przełącznik --diagnostic. Dostępne wartości to Trace, Debug, Information, Warning, Errorlub Critical.

• --exit-on-process-exit

  Zakończ proces testowy, jeśli proces zależny zakończy działanie. Należy podać piD.

• --help

  Wyświetla opis sposobu używania polecenia .

• --ignore-exit-code

  Zezwala na ignorowanie niektórych kodów zakończenia innych niż zero, i zamiast tego są zwracane jako 0. Aby uzyskać więcej informacji, sprawdź Ignoruj określone kody zakończenia.

• --info

  Wyświetla zaawansowane informacje o aplikacji testowej .NET, takie jak:

  • Platforma.
  • Środowisko.
  • Każdy zarejestrowany dostawca wiersza polecenia, taki jak np. name, version, descriptioni options.
  • Każde zarejestrowane narzędzie, takie jak jego command, name, version, description, i wszyscy dostawcy wiersza polecenia.

  Ta funkcja służy do zrozumienia rozszerzeń, które będą rejestrować tę samą opcję wiersza polecenia lub zmiany dostępnych opcji między wieloma wersjami rozszerzenia (lub platformy).

• --list-tests

  Wyświetl listę dostępnych testów. Testy nie zostaną wykonane.

• --maximum-failed-tests

  Określa maksymalną liczbę niepowodzeń testów, które po osiągnięciu zatrzymają przebieg testu. Obsługa tego przełącznika wymaga od autorów platform zaimplementowania możliwości IGracefulStopTestExecutionCapability. Kod zakończenia po osiągnięciu tej liczby niepowodzeń testów wynosi 13. Aby uzyskać więcej informacji, zobacz Microsoft.Testing.Platform kody wyjścia.

  Uwaga / Notatka

  Ta funkcja jest dostępna w witrynie Microsoft.Testing.Platform, począwszy od wersji 1.5.

• --minimum-expected-tests

  Określa minimalną liczbę testów, które mają zostać uruchomione. Domyślnie oczekuje się, że co najmniej jeden test zostanie uruchomiony.

• --results-directory

  Katalog, w którym zostaną umieszczone wyniki testu. Jeśli określony katalog nie istnieje, zostanie utworzony. Wartość domyślna to TestResults w katalogu zawierającym aplikację testową.

• --timeout

  Globalny limit czasu wykonywania testów. Przyjmuje jeden argument jako ciąg w formacie <value>[h|m|s], gdzie <value> jest liczbą zmiennoprzecinkową.

Opcje rozszerzenia według scenariusza

Skorzystaj z poniższej tabeli, aby szybko znaleźć opcje rozszerzenia.

Scenariusz	Dokumentacja funkcji
Zbieranie pokrycia kodu	Pokrycie kodu
Zbieranie zrzutów awaryjnych lub zawieszania się	Zrzuty awaryjne i zawieszania się
Generowanie raportów testowych (na przykład TRX)	Raporty testowe
Dostosowywanie danych wyjściowych terminalu	Dane wyjściowe terminalu
Stosowanie kontrolek na poziomie hostingu	Hot Reload
Ponów nieudane testy	ponów próbę
Uruchamianie testów korzystających z platformy Microsoft Fakes	Microsoft Fakes
Emitowanie śladów i metryk OpenTelemetry	OpenTelemetry

Odnajdywanie opcji w aplikacji testowej

Uruchom plik wykonywalny testowy za pomocą polecenia , --help aby wyświetlić listę opcji dostępnych dla bieżącego zestawu rozszerzeń.

Aby uzyskać zaawansowaną diagnostykę zarejestrowanych dostawców i opcji, uruchom z parametrem --info.

Zobacz także

• Microsoft.Testing.Platform — omówienie
• Funkcje Microsoft.Testing.Platform
• Testowanie za pomocą polecenia dotnet test