dotnet test

Ten artykuł dotyczy: ✔️ zestaw .NET 6 SDK i nowsze wersje

Nazwisko

dotnet test — Sterownik testowy platformy .NET używany do wykonywania testów jednostkowych.

opis

Polecenie dotnet test kompiluje rozwiązanie i uruchamia testy za pomocą platformy VSTest lub Microsoft Testing Platform (MTP). Używany moduł uruchamiający testy określa dostępne opcje i zachowanie wiersza polecenia.

Uwaga / Notatka

Wybór modułu uruchamiającego testy jest dostępny od zestawu SDK platformy .NET 10. We wcześniejszych wersjach platformy .NET testy są zawsze wykonywane za pomocą narzędzia VSTest.

Wybieranie modułu uruchamiającego testy

W przypadku zestawu .NET 10 SDK i nowszych wersji wybierz pozycję Microsoft. Testing.Platform (MTP) w global.json pliku:

{
    "test": {
        "runner": "Microsoft.Testing.Platform"
    }
}

Uwaga / Notatka

VSTest jest prawidłową wartością modułu uruchamiającego testy. Jest to bieżąca wartość domyślna i można ją pominąć.

Ważne

Środowisko dotnet test MTP jest obsługiwane tylko w Microsoft.Testing.Platform wersji 1.7 lub nowszej.

Począwszy od .NET 11 (wersja zapoznawcza 6), ustaw zmienną DOTNET_TEST_RUNNER środowiskową, aby wybrać moduł uruchamiający bez zmiany .global.json Zmienna środowiskowa akceptuje VSTest wartość lub Microsoft.Testing.Platform, bez względu na wielkość liter i zastępuje global.json wartość:

$env:DOTNET_TEST_RUNNER = "Microsoft.Testing.Platform"
dotnet test
DOTNET_TEST_RUNNER=Microsoft.Testing.Platform dotnet test

Jeśli zmienna środowiskowa jest pusta lub zawiera nierozpoznaną wartość, dotnet test użyj wartości global.json . Jeśli żadne ustawienie nie wybierze modułu uruchamiającego, dotnet test użyj narzędzia VSTest.

Dokumentacja modułu uruchamiającego testy

Dostępne opcje wiersza polecenia, zachowanie i możliwości różnią się w zależności od używanego modułu uruchamiającego testy:

  • dotnet test with VSTest — tradycyjna platforma testowa dostępna w zestawie .NET 6 SDK i nowszych wersjach. Jest to domyślny i tylko moduł uruchamiający testy w wersjach starszych niż zestaw SDK platformy .NET 10. Zapewnia kompleksowe funkcje odnajdywania, filtrowania i raportowania wyników testów.

  • dotnet test z MTP — nowoczesna platforma testowania dostępna w zestawie .NET 10 SDK i nowszych wersjach. Oferuje szybsze wykonywanie testów i bardziej elastyczny wybór modułu testowego.

Wskazówka

Aby uzyskać dokumentację koncepcyjną dotyczącą dotnet testusługi , zobacz Testowanie za pomocą testu dotnet.

Zobacz też