Sprawdzanie obsługi Visual Studio Code na potrzeby testowania jednostkowego

Ukończone

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ń. Wyszukaj Test:, 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.Sdk
  • xUnit
  • xunit.runner.visualstudio
  • coverlet.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.Sdk
  • NUnit
  • NUnit3TestAdapter

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.Sdk
  • MSTest.TestAdapter
  • MSTest.TestFramework
  • coverlet.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 Testsi Test: Show Output z palety poleceń.
  • Ustawienia testowania: wyszukaj Testing w 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:

  1. 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.
  2. Generowanie kodu testowego: użyj GitHub Copilot w widoku czatu, aby wygenerować testy jednostkowe dla kodu aplikacji. Następne lekcji obejmują ten etap.
  3. 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.