Sprawdzanie obsługi Visual Studio Code na potrzeby testowania jednostkowego
Zanim będzie można wygenerować testy jednostkowe przy użyciu GitHub Copilot, projekt wymaga działającej platformy testowej i sposobu uruchamiania testów wewnątrz Visual Studio Code. Visual Studio Code zestaw SDK .NET i rozszerzenie zestawu deweloperskiego języka C# zapewniają środowisko, które hostuje testy jednostkowe, a GitHub Copilot koncentruje się na generowaniu i udoskonalaniu kodu testowego. Zrozumienie środowiska bazowego znacznie ułatwia śledzenie przepływu pracy GitHub Copilot.
W tej lekcji przedstawiono funkcje Visual Studio Code i narzędzia języka C#, które obsługują testowanie jednostkowe. W kolejnych lekcjach skoncentrujemy się na tym, jak GitHub Copilot generuje i utrzymuje kod testowy uruchamiany w tym środowisku.
Obsługa testów jednostkowych w Visual Studio Code
Aby utworzyć i uruchomić testy jednostkowe języka C# w Visual Studio Code, potrzebne są następujące zasoby:
- Zestaw SDK .NET 8.0 lub nowszy.
- Rozszerzenie zestawu deweloperskiego języka C# dla Visual Studio Code.
- Pakiet platformy testowej dodany do projektu.
Obsługa zestawu deweloperskiego języka C# na potrzeby testów jednostkowych
Rozszerzenie C# Dev Kit udostępnia funkcje testowania używane w tym module:
- Eksplorator testów: widok drzewa przedstawiający wszystkie przypadki testowe w obszarze roboczym. Eksplorator testów można otworzyć, wybierając ikonę beaker na pasku działania.
- Uruchamianie/debugowanie przypadków testowych: w edytorze obok każdej klasy testowej i każdej metody pojawiają się zielone przyciski uruchamiania. Kliknij prawym przyciskiem myszy przycisk odtwarzania, aby wyświetlić więcej opcji.
- Wyświetlanie wyników testu: po uruchomieniu testu wynik zostanie odzwierciedlony w dekoracjach edytora i w Eksploratorze testów. Wybranie linku w śladzie stosu powoduje przejście do lokalizacji źródłowej.
-
Polecenia testowania: polecenia, takie jak
Test: Run All Tests, są dostępne w palecie poleceń. WyszukajTest:, aby zobaczyć pełną listę. -
Ustawienia testów: Ustawienia kontrolujące odnajdywanie testów i działanie w czasie wykonywania są dostępne w edytorze ustawień. Wyszukaj
Testing, aby wyświetlić dostępne opcje.
Zestaw deweloperski języka C# obsługuje następujące struktury testowe:
- xUnit
- NUnit
- MSTest
Tworzenie projektu testowego przy użyciu palety poleceń
Paleta poleceń w Visual Studio Code zapewnia najprostszy sposób tworzenia projektu testowego korzystającego z obsługiwanej platformy. Paletę poleceń można otworzyć w następujący sposób:
- Naciśnij Ctrl + Shift + P klucze (Windows/Linux)) lub Cmd + Shift + P (macOS).
- Otwórz menu Widok , a następnie wybierz pozycję Paleta poleceń.
- Otwórz widok Eksplorator rozwiązań, kliknij prawym przyciskiem myszy na folder rozwiązania, a następnie wybierz pozycję Nowy Projekt. Ta opcja otwiera paletę poleceń z już wybranym poleceniem .NET: Nowy projekt...
W poniższych sekcjach pokazano, jak utworzyć projekt testowy dla każdej obsługiwanej platformy.
xUnit
Otwórz paletę poleceń i wybierz pozycję .NET: Nowy Project... wybierz pozycję xUnit Test Project, a następnie podaj nazwę i lokalizację dla nowego project. To polecenie tworzy projekt, który używa narzędzia xUnit jako biblioteki testowej i konfiguruje moduł uruchamiający testy, dodając następujące <PackageReference /> elementy do pliku projektu:
Microsoft.NET.Test.SdkxUnitxunit.runner.visualstudiocoverlet.collector
W zintegrowanym terminalu można dodać odwołanie z projektu testowego do testowanego projektu:
dotnet add [location of your test csproj file] reference [location of the csproj file for project to be tested]
NUnit
Otwórz paletę poleceń i wybierz pozycję .NET: Nowy Project... wybierz pozycję NUnit3 Test Project, a następnie podaj nazwę i lokalizację dla nowego project. To polecenie tworzy projekt, który używa narzędzia NUnit jako biblioteki testowej i dodaje następujące <PackageReference /> elementy do pliku projektu:
Microsoft.NET.Test.SdkNUnitNUnit3TestAdapter
Dodaj odwołanie do projektu testowego z poziomu terminalu:
dotnet add [location of your test csproj file] reference [location of the csproj file for project to be tested]
MSTest
Otwórz paletę poleceń i wybierz pozycję .NET: Nowy Project... wybierz pozycję MSTest Test Project, a następnie podaj nazwę i lokalizację dla nowego project. To polecenie dodaje następujące <PackageReference /> elementy do pliku projektu:
Microsoft.NET.Test.SdkMSTest.TestAdapterMSTest.TestFrameworkcoverlet.collector
Dodaj odwołanie do projektu testowego z poziomu terminalu:
dotnet add [location of your test csproj file] reference [location of the csproj file for project to be tested]
Uruchamianie testów jednostkowych i zarządzanie nimi w Visual Studio Code
Po utworzeniu projektu testowego Visual Studio Code i zestaw deweloperski języka C# zapewniają kilka sposobów uruchamiania testów i zarządzania nimi:
- Uruchom/Debuguj z edytora: wybierz zielony przycisk odtwarzania obok klasy lub metody, aby uruchomić ten element docelowy. Kliknij prawym przyciskiem myszy przycisk odtwarzania, aby wyświetlić opcje, takie jak Uruchom test i Test debugowania.
- Eksplorator testów: uruchom lub debuguj poszczególne testy, grupy lub pełny pakiet z widoku drzewa. Wyniki testów, w tym ikony pass/fail i czasy trwania, są wyświetlane obok każdego elementu.
- Wyświetl wyniki testu: dekoracje edytora i Eksplorator testów odzwierciedlają bieżący stan każdego testu po uruchomieniu. Wybierz łącza w śladach stosu, aby przejść do wiersza powodującego błąd.
-
Polecenia testowania: użyj poleceń, takich jak
Test: Run All Tests,Test: Debug Failed TestsiTest: Show Outputz palety poleceń. -
Ustawienia testowania: wyszukaj
Testingw edytorze ustawień, aby skonfigurować zachowanie, takie jak automatyczne uruchamianie przy formatowaniu wyników zapisu lub testu.
Przepływ testowania jednostkowego z GitHub Copilot
Po połączeniu Visual Studio Code z GitHub Copilot proces testowania jednostkowego dzieli się na trzy etapy:
Set up the environment : Use Visual Studio Code, the .NET SDK and the C# Dev Kit (Konfigurowanie środowiska: Użyj Visual Studio Code, zestawu SDK .NET i zestawu deweloperskiego języka C#, aby utworzyć projekt testowy i odwołać się do projektu w ramach testu. Ukończyłeś ten etap w tym module.- Generowanie kodu testowego: użyj GitHub Copilot w widoku czatu, aby wygenerować testy jednostkowe dla kodu aplikacji. Następne lekcji obejmują ten etap.
- Uruchom i konserwuj testy: Użyj Eksploratora testów i zestawu deweloperskiego języka C#, aby uruchomić testy, a następnie użyć GitHub Copilot, aby rozszerzyć pokrycie i naprawić testy zakończone niepowodzeniem.
Pozostałe jednostki koncentrują się na narzędziach GitHub Copilot, które obsługują etapy 2 i 3.