How to run tests and debug Google Test project in VS Code?

1. Start with a clean directory:

/home/user/Desktop/projects/cpp/ # your project lives here

2. Add your cmake file(CMakeLists.txt), your source files, and test file. The directory now looks like this:

└─cpp/
    ├─ CMakeLists.txt
    ├─ myfunctions.h
    └─ mytests.cpp

3. Clone and add googletest to this directory:

└─cpp/
    ├─ googletest/
    ├─ CMakeLists.txt
    ├─ myfunctions.h
    └─ mytests.cpp

4. Open your CMakeLists.txt and enter the following:

cmake_minimum_required(VERSION 3.12) # version can be different

set(GOOGLETEST_VERSION 1.15.2)

project(my_cpp_project) #name of your project

enable_testing() #to  discover tests in test explorer 

add_subdirectory(googletest) # add googletest subdirectory

include_directories(googletest/include) # this is so we can #include <gtest/gtest.h>

add_executable(mytests mytests.cpp) # add this executable

target_link_libraries(mytests PRIVATE gtest) # link google test to this executable

include(GoogleTest)
gtest_discover_tests(mytests) # discovers tests by asking the compiled test executable to enumerate its tests

5. Contents of myfunctions.h for the example:

#ifndef _ADD_H
#define _ADD_H

int add(int a, int b)
{
    return a + b;
}

#endif

6. Contents of mytests.cpp for the example:

#include <gtest/gtest.h>
#include "myfunctions.h"

TEST(myfunctions, add)
{
    GTEST_ASSERT_EQ(add(10, 22), 32);
}

int main(int argc, char* argv[])
{
    ::testing::InitGoogleTest(&argc, argv);
    return RUN_ALL_TESTS();
}

Now you just have to run the tests. There are multiple ways to do that.

In the terminal, create a build/ dir in cpp/:

mkdir build

Your directory should now look like this:

└─cpp/
    ├─ build/
    ├─ googletest/
    ├─ CMakeLists.txt
    ├─ myfunctions.h
    └─ mytests.cpp

Next go into the build directory:

cd build

Then run:

cmake ..
make
./mytests

Alternative way:

• Install the CMake Tools extension for VS Code
• In the bottom bar, you can see the current target (in square brackets Build [mytest] and Run [mytest])you want to build / run:
• Then just click the run button.

Building Google test itself

Using terminal:

1. Go into the dir /home/user/Desktop/projects/cpp/googletest
2. Create build/ inside it so that it looks like following:

└─cpp/googletest/
    ├─ build/
    ├─ ...other googletest files

3. cd build
4. Run: cmake -Dgtest_build_samples=ON -DCMAKE_BUILD_TYPE=Debug ..
5. make -j4
6. ./googletest/sample1_unittest

Using VS-Code

1. Open the googletest folder into VS Code
2. CMake extension will prompt for configuration, allow it
3. You will see a .vscode directory. Inside it is settings.json file, open it, and add the following to it:

    "cmake.configureSettings": { "gtest_build_samples": "ON" }

4. Build and run from the buttons in the bottom bar