Microsoft.Testing.Platform — omówienie

Microsoft.Testing.Platform to uproszczona i przenośna alternatywa dla programu VSTest do uruchamiania testów we wszystkich kontekstach, w tym potoków ciągłej integracji, interfejsu wiersza polecenia, Eksploratora testów programu Visual Studio i Eksploratora tekstu programu VS Code. Platforma Microsoft.Testing.Platform jest osadzona bezpośrednio w projektach testowych i nie ma żadnych innych zależności aplikacji, takich jak vstest.console lub dotnet test potrzebne do uruchamiania testów.

Microsoft.Testing.Platform jest oprogramowaniem open source. Kod można znaleźć Microsoft.Testing.Platform w repozytorium Microsoft/testfx w witrynie GitHub.

Obsługiwane platformy testowe

• MSTest. W narzędziu MSTest obsługa jest wykonywana za pośrednictwem modułu Microsoft.Testing.Platform uruchamiającego MSTest.
• NUnit. W NUnit obsługa jest wykonywana za pośrednictwem modułu Microsoft.Testing.Platform uruchamiającego NUnit.
• xUnit: praca w toku, aby uzyskać więcej informacji, zobacz Microsoft Testing Platform for xUnit.
• TUnit: całkowicie skonstruowany na Microsoft.Testing.Platformpodstawie elementu , aby uzyskać więcej informacji, zobacz dokumentację TUnit

Uruchamianie i debugowanie testów

Microsoft.Testing.Platform projekty testowe są tworzone jako pliki wykonywalne, które można uruchamiać (lub debugować) bezpośrednio. Nie ma dodatkowego testu z uruchomioną konsolą lub poleceniem. Aplikacja kończy działanie z kodem zakończenia niezerowym, jeśli występuje błąd, jak zwykle w przypadku większości plików wykonywalnych. Aby uzyskać więcej informacji na temat znanych kodów zakończenia, zobacz Microsoft.Testing.Platform exit codes (Kody zakończenia platformy Microsoft.Testing.Platform).

Ważne

Domyślnie Microsoft.Testing.Platform zbiera dane telemetryczne. Aby uzyskać więcej informacji i opcji rezygnacji, zobacz Microsoft.Testing.Platform telemetria.

Interfejs wiersza polecenia platformy .NET

Publikowanie projektu testowego przy użyciu aplikacji dotnet publish i uruchamianie jej bezpośrednio jest innym sposobem uruchamiania testów. Na przykład wykonanie polecenia ./Contoso.MyTests.exe. W niektórych scenariuszach można go również użyć dotnet build do utworzenia pliku wykonywalnego, ale mogą istnieć przypadki brzegowe, takie jak natywna AOT.

Korzystanie z polecenia dotnet run

Polecenie dotnet run może służyć do kompilowania i uruchamiania projektu testowego. Jest to najprostszy, choć czasami najwolniejszy sposób uruchamiania testów. Użycie dotnet run jest praktyczne podczas edytowania i uruchamiania testów lokalnie, ponieważ gwarantuje, że projekt testowy zostanie ponownie skompilowany w razie potrzeby. dotnet run program automatycznie znajdzie również projekt w bieżącym folderze.

dotnet run --project Contoso.MyTests

Aby uzyskać więcej informacji na temat dotnet runprogramu , zobacz dotnet run.

Korzystanie z polecenia dotnet exec

Polecenie dotnet exec or dotnet służy do wykonywania (lub uruchamiania) już skompilowany projekt testowy. Jest to alternatywa dla bezpośredniego uruchamiania aplikacji. dotnet exec wymaga ścieżki do skompilowanych bibliotek dll projektu testowego.

dotnet exec Contoso.MyTests.dll

or

dotnet Contoso.MyTests.dll

Uwaga

Podanie ścieżki do pliku wykonywalnego projektu testowego (*.exe) powoduje wystąpienie błędu:

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\net8.0\Contoso.MyTests.exe'

Aby uzyskać więcej informacji na temat dotnet execprogramu , zobacz dotnet exec.

Korzystanie z polecenia dotnet test

Microsoft.Testing.Platform oferuje warstwę zgodności i vstest.console.exe dotnet test zapewnia możliwość uruchamiania testów tak jak wcześniej podczas włączania nowego scenariusza wykonywania.

dotnet test Contoso.MyTests.dll

Program Visual Studio

Testy Microsoft.Testing.Platform można uruchamiać (i debugować) w programie Visual Studio, integrować je z Eksploratorem testów, a także uruchamiać je bezpośrednio jako projekt startowy.

Uruchamianie aplikacji za pomocą programu Visual Studio

Microsoft.Testing.Platform projekt testowy jest kompilowany jako pliki wykonywalne i można go uruchamiać bezpośrednio. Spowoduje to uruchomienie wszystkich testów w danym pliku wykonywalnym, chyba że zostanie podany filtr.

1. Przejdź do projektu testowego, który chcesz uruchomić w Eksplorator rozwiązań, wybierz go prawym przyciskiem i wybierz pozycję Ustaw jako projekt startowy.
2. Wybierz pozycję Debuguj>rozpocznij bez debugowania (lub użyj Ctrl+F5), aby uruchomić wybrany projekt testowy.

Zostanie wyświetlone okno konsoli z wykonaniem i podsumowaniem przebiegu testu.

Debugowanie aplikacji bezpośrednio w programie Visual Studio

Microsoft.Testing.Platform projekt testowy można debugować bezpośrednio. Aby debugować wszystkie testy w danym pliku wykonywalnym, chyba że podano filtr:

1. Przejdź do projektu testowego, który chcesz uruchomić w Eksplorator rozwiązań, wybierz go prawym przyciskiem i wybierz pozycję Ustaw jako projekt startowy.
2. Ustaw punkt przerwania w teście, który chcesz debugować.
3. Przejdź do pozycji Debuguj>Rozpocznij debugowanie (lub naciśnij F5), aby debugować wybrany projekt testowy.

Wszystkie testy są wykonywane do momentu osiągnięcia testu z punktem przerwania. Przekrocznij test, aby go debugować. Po zakończeniu debugowania aplikacja wznowi uruchamianie wszystkich pozostałych testów, chyba że ją zatrzymasz.

Korzystanie z Eksploratora testów

Aby uruchomić test, przejdź do Eksploratora testów, wybierz test (lub testy), które chcesz uruchomić. Wybierz go prawym przyciskiem i wybierz polecenie Uruchom. Podobnie jak w przypadku debugowania testu, wybierz test (lub testy) w Eksploratorze testów, wybierz prawym przyciskiem i wybierz polecenie Debuguj.

Uwaga

Automatyczna aktualizacja testów bez kompilowania projektu jest niedostępna.

Visual Studio Code

Rozszerzenie języka C# wraz z zestawem C# Dev Kit umożliwia debugowanie/uruchamianie testów w programie Visual Studio Code, a także dodaje integrację z Eksploratorem testów programu Visual Studio Code.

Uruchamianie aplikacji za pomocą programu Visual Studio Code

Microsoft.Testing.Platform projekt testowy jest kompilowany jako pliki wykonywalne i można go uruchamiać bezpośrednio. Spowoduje to uruchomienie wszystkich testów w danym pliku wykonywalnym, chyba że zostanie podany filtr.

1. Przejdź do pliku testowego, dla którego chcesz uruchomić testy.
2. Użyj Ctrl+F5, aby uruchomić wybrany projekt testowy. Jeśli masz wiele projektów, zostanie wyświetlone wyskakujące okienko z prośbą o wybranie jednego do uruchomienia.

Zostanie wyświetlone okno konsoli z wykonaniem i podsumowaniem przebiegu testu.

Debugowanie aplikacji bezpośrednio w programie Visual Studio Code

Microsoft.Testing.Platform projekt testowy jest kompilowany jako pliki wykonywalne i można go uruchamiać bezpośrednio. Spowoduje to uruchomienie wszystkich testów w danym pliku wykonywalnym, chyba że zostanie podany filtr.

1. Przejdź do pliku testowego, dla którego chcesz uruchomić testy.
2. Użyj F5 , aby debugować wybrany projekt testowy. Jeśli masz wiele projektów, zostanie wyświetlone wyskakujące okienko z prośbą o wybranie jednego do uruchomienia.

Napiwek

Istnieje kilka innych sposobów uruchamiania projektu dotnet przy użyciu zestawu deweloperskiego języka C#, na przykład uruchamiania z poziomu Eksploratora rozwiązań lub tworzenia odpowiednich konfiguracji uruchamiania. Są one określone w dokumentacji programu Visual Studio Code.

Podczas uruchamiania projektu zostanie otwarta karta danych wyjściowych z wykonaniem i podsumowaniem przebiegu testu.

Korzystanie z Eksploratora testów

Aby uruchomić test, przejdź do Eksploratora testów, wybierz test (lub testy), które chcesz uruchomić. Wybierz go prawym przyciskiem i wybierz polecenie Uruchom. Podobnie jak w przypadku debugowania testu, wybierz test (lub testy) w Eksploratorze testów, wybierz prawym przyciskiem i wybierz polecenie Debuguj.

Uwaga

Automatyczna aktualizacja testów bez kompilowania projektu jest niedostępna.

Ciągła integracja (CI)

Nie ma specjalnego zadania potoku ani żadnych dodatkowych narzędzi do uruchamiania Testing.Platform testów. Nie ma również innych narzędzi wymaganych do uruchamiania wielu projektów testów za pomocą jednego polecenia.

Aby uruchomić projekt testowy w ciągłej integracji, dodaj jeden krok dla każdego pliku wykonywalnego testu, który chcesz uruchomić, na przykład w usłudze Azure DevOps:

- task: CmdLine@2
  displayName: "Run Contoso.MyTests"
  inputs:
    script: '.\Contoso.MyTests\bin\Debug\net8.0\Contoso.MyTests.exe'

Opcje

Poniższa lista zawiera tylko opcje platformy. Aby wyświetlić określone opcje wprowadzone przez każde rozszerzenie, zapoznaj się ze stroną dokumentacji rozszerzenia lub użyj --help opcji .

• --diagnostic

Włącza rejestrowanie diagnostyczne. Domyślnym poziomem dziennika jest Trace. Plik jest zapisywany w katalogu wyjściowym o następującym formacie nazwy: log_[MMddHHssfff].diag.

• --diagnostic-filelogger-synchronouswrite

Wymusza wbudowany rejestrator plików w celu synchronicznego zapisywania dzienników. Przydatne w scenariuszach, w których nie chcesz utracić żadnych wpisów dziennika (jeśli proces ulegnie awarii). Spowoduje to spowolnienie wykonywania testu.

• --diagnostic-output-directory

Katalog wyjściowy rejestrowania diagnostycznego, jeśli nie określono pliku, jest generowany w domyślnym katalogu TestResults .

• --diagnostic-output-fileprefix

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

• --diagnostic-verbosity

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

• --help

Wyświetla opis sposobu używania polecenia .

• -ignore-exit-code

Zezwala na ignorowanie niektórych kodów zakończenia innych niż zero, a zamiast tego zwracane jako 0. Aby uzyskać więcej informacji, zobacz 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 jego, name, versiondescription i options.
• Każde zarejestrowane narzędzie, takie jak jego, command, name, version, descriptioni wszystkich dostawców 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.

• --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 znajduje TestResults się w katalogu zawierającym aplikację testową.

Integracja z programem MSBuild

Pakiet NuGet Microsoft.Testing.Platform.MSBuild zapewnia różne integracje z Microsoft.Testing.Platform programem MSBuild:

• dotnet testAby uzyskać więcej informacji, zobacz obsługa systemu , zobacz dotnet test integration (Integracja z testem dotnet).
• Obsługa wymagana ProjectCapability przez Visual Studio eksploratory testów i Visual Studio Code .
• Automatyczne generowanie punktu wejścia (Main metoda)
• Automatyczne generowanie pliku konfiguracji

Uwaga

Ta integracja działa w sposób przejściowy (projekt odwołujący się do innego projektu odwołującego się do tego pakietu będzie zachowywał się tak, jakby odwołuje się do pakietu) i można go wyłączyć za pomocą IsTestingPlatformApplication właściwości MSBuild.

Zobacz też

• Porównanie Microsoft.Testing.Platform i VSTest
• Microsoft.Testing.Platform — rozszerzenia
• Microsoft.Testing.Platform — telemetria
• Microsoft.Testing.Platform — kody zakończenia