Pisanie testów jednostkowych dla języka C/C++ w programie Visual Studio

Testy jednostkowe języka C++ można pisać i uruchamiać przy użyciu okna Eksploratora testów. Działa tak samo jak w przypadku innych języków. Aby uzyskać więcej informacji na temat korzystania z Eksploratora testów, zobacz Run unit tests with Test Explorer (Uruchamianie testów jednostkowych za pomocą Eksploratora testów).

Program Visual Studio obejmuje te struktury testowe języka C++ bez dodatkowych plików do pobrania:

• Microsoft Unit Testing Framework for C++
• Google Test
• Boost.Test
• CTest

Możesz użyć zainstalowanych struktur lub napisać własną kartę testową dla dowolnej platformy, która ma być używana w programie Visual Studio. Adapter testowy integruje testy jednostkowe z oknem Eksplorator testów. Dostępnych jest kilka adapterów innych niż Microsoft na Visual Studio Marketplace. Aby uzyskać więcej informacji, zobacz Instalowanie struktur testów jednostkowych.

• Program Visual Studio 2017 lub nowszy (Professional i Enterprise)

  Projekty testów jednostkowych języka C++ obsługują rozwiązanie CodeLens.

• Program Visual Studio 2017 lub nowszy (wszystkie wersje)

  • Karta Google Test Adapter jest dołączana jako domyślny składnik tworzenia aplikacji klasycznych z obciążeniem języka C++ . Ma szablon projektu, który można dodać do rozwiązania. Kliknij prawym przyciskiem myszy węzeł rozwiązania w Eksplorator rozwiązań i wybierz polecenie > w menu skrótów, aby dodać szablon projektu. Dostępne są również opcje, które można skonfigurować przy użyciu narzędzi Tools>Options. Aby uzyskać więcej informacji, zobacz How to: Use Google Test in Visual Studio (Jak używać usługi Google Test w programie Visual Studio).

  • Plik Boost.Test jest dołączany jako domyślny składnik tworzenia aplikacji klasycznych z obciążeniem języka C++ . Jest ona zintegrowana z Eksploratorem testów, ale obecnie nie ma szablonu projektu. Należy ją skonfigurować ręcznie. Aby uzyskać więcej informacji, zobacz How to: Use Boost.Test in Visual Studio (Jak używać narzędzia Boost.Test w programie Visual Studio).

  • Obsługa języka CTest jest zawarta w składniku narzędzi CMake języka C++, który jest częścią tworzenia aplikacji klasycznych z obciążeniem języka C++ . Aby uzyskać więcej informacji, zobacz How to: Use CTest in Visual Studio (Jak używać narzędzia CTest w programie Visual Studio).

• Starsze wersje programu Visual Studio

  Adapter Google Test i rozszerzenia Boost.Test Adapter można pobrać w witrynie Visual Studio Marketplace. Znajdź je na karcie Test for Boost.Test i Test adapter for Google Test.

Podstawowy przepływ pracy testu

W poniższych sekcjach przedstawiono podstawowe kroki umożliwiające rozpoczęcie testowania jednostkowego języka C++. Podstawowa konfiguracja jest podobna zarówno dla platform Microsoft, jak i Google Test. Plik Boost.Test wymaga ręcznego utworzenia projektu testowego.

Tworzenie odwołań do innych projektów w rozwiązaniu

Aby umożliwić dostęp do funkcji w projekcie testowym, dodaj odwołanie do projektu w projekcie testowym. W eksploratorze rozwiązań rozwiń projekt testowy. Kliknij prawym przyciskiem myszy Odwołania, a następnie wybierz Dodaj odwołanie>. W oknie dialogowym Dodaj odwołanie wybierz projekty, które chcesz przetestować.

Łącze do plików obiektów lub bibliotek

Jeśli kod testowy nie eksportuje funkcji, które chcesz przetestować, dodaj pliki wyjściowe .obj lub .lib do zależności projektu testowego. Aby uzyskać więcej informacji, zobacz Aby połączyć testy z plikami obiektów lub biblioteki. Nie dołączaj plików obiektów, które mają main funkcję lub inny standardowy punkt wejścia, taki jak wmain, WinMainlub DllMain. Po dodaniu nowych plików źródłowych do projektu zaktualizuj zależności projektu testowego, aby uwzględnić odpowiednie pliki obiektów.

Dodawanie dyrektyw #include dla plików nagłówków

W pliku testów jednostkowych .cpp dodaj dyrektywę #include dla dowolnych plików nagłówkowych, które deklarują typy i funkcje, które chcesz przetestować. Wpisz #include "polecenie , a następnie aktywuje funkcję IntelliSense, aby ułatwić wybór. Powtórz, aby uzyskać więcej nagłówków.

Pisanie metod testowych

Plik .cpp w projekcie testowym ma zdefiniowaną klasę typu stub oraz metodę. Pokazują przykład sposobu pisania kodu testowego. Podpisy używają makr TEST_CLASS i TEST_METHOD, dzięki czemu metody są wykrywalne w oknie Eksplorator testów.

TEST_CLASS i TEST_METHOD są częścią platformy Microsoft Native Test Framework. Eksplorator testów odnajduje metody testowania w innych obsługiwanych platformach w podobny sposób.

TEST_METHOD zwraca wartość void. Aby wygenerować wynik testu, użyj metod statycznych w Assert klasie, aby przetestować rzeczywiste wyniki względem oczekiwanych wyników. W poniższym przykładzie przyjęto MyClass założenie, że ma konstruktor, który przyjmuje std::stringelement . W tym przykładzie pokazano, jak można przetestować, czy konstruktor inicjuje klasę w oczekiwany sposób:

TEST_METHOD(TestClassInit)
{
    std::string name = "Bill";
    MyClass mc(name);
    Assert::AreEqual(name, mc.GetName());
}

W poprzednim przykładzie wynik Assert::AreEqual wywołania określa, czy test przebiegnie pomyślnie, czy kończy się niepowodzeniem. Klasa Assert zawiera wiele innych metod porównywania oczekiwanych wyników z rzeczywistymi wynikami.

Możesz dodać cechy do metod testowych w celu określenia właścicieli testów, priorytetu i innych informacji. Następnie możesz użyć tych wartości do sortowania i grupowania testów w Eksploratorze testów. Aby uzyskać więcej informacji, zobacz Uruchamianie testów jednostkowych za pomocą Eksploratora testów.

Uruchamianie testów

1. Na menu Test wybierz Eksplorator testów. Poniższa ilustracja przedstawia projekt testowy przed uruchomieniem testów.

   

   

   Uwaga

   Integracja narzędzia CTest z Eksploratorem testów nie jest jeszcze dostępna. Uruchom testy CTest z menu głównego narzędzia CMake.

2. Jeśli w oknie brakuje któregokolwiek z testów, skompiluj projekt testowy, klikając prawym przyciskiem myszy jego węzeł w Eksplorator rozwiązań i wybierając polecenie Kompiluj lub Odbuduj.

3. W Eksploratorze testów wybierz pozycję Uruchom wszystko lub wybierz określone testy, które chcesz uruchomić. Kliknij prawym przyciskiem myszy test dla innych opcji, w tym uruchomienie go w trybie debugowania z włączonymi punktami przerwania. Po uruchomieniu wszystkich testów w oknie są wyświetlane testy, które zakończyły się powodzeniem, oraz testy, które zakończyły się niepowodzeniem.

   

   

W przypadku testów, które zakończyły się niepowodzeniem, komunikat wyświetla szczegóły, które ułatwiają diagnozowanie przyczyny. Kliknij prawym przyciskiem myszy test zakończony niepowodzeniem dla menu podręcznego. Wybierz pozycję Debuguj , aby przejść przez funkcję, w której wystąpił błąd.

Aby uzyskać więcej informacji na temat korzystania z Eksploratora testów, zobacz Run unit tests with Test Explorer (Uruchamianie testów jednostkowych za pomocą Eksploratora testów).

Aby uzyskać więcej informacji na temat testowania jednostkowego, zobacz Podstawy testu jednostkowego.

Korzystanie z funkcji CodeLens

Program Visual Studio 2017 lub nowszy (wersje Professional i Enterprise)

Funkcja CodeLens umożliwia szybkie wyświetlanie stanu testu jednostkowego bez opuszczania edytora kodu.

Zainicjuj kodLens dla projektu testu jednostkowego języka C++ na dowolny z następujących sposobów:

• Edytuj i skompiluj projekt testowy lub rozwiązanie.
• Ponownie skompiluj projekt lub rozwiązanie.
• Uruchom testy w oknie Eksplorator testów.

Po zainicjowaniu funkcji CodeLens można zobaczyć ikony stanu testu nad każdym testem jednostkowym.

Wybierz ikonę, aby uzyskać więcej informacji, lub aby uruchomić lub debugować test jednostkowy:

Powiązana zawartość

• Testowanie jednostkowe kodu