This extension is a Visual Studio Code Test Adapter for the Test Explorer UI extension. It integrates with the CppUnitTestFramework unit testing library.
Configuration
Each workspace must be configured in order for the extension to work correctly. The following settings are available:
Property
Description
cppUnitTestFramework.executable
Required: The path to the compiled unit test executable. Can be absolute or relative to the workspace.
cppUnitTestFramework.workingDirectory
Optional: The working directory to use when running the unit test executable. Can be absolute or relative to the workspace. Defaults to the executable directory.
cppUnitTestFramework.environment
Optional: A map of additional environment variables to apply when running the unit test executable.
cppUnitTestFramework.debugLogging
Optional: Enabled debug logging for the extension. Defaults to false.
cppUnitTestFramework.buildDirectory
Optional: The build directory to use when resolving source file references, such as ./build when using CMake.
Debugging
Debugging is handled through the ms-vscode.cpptools extension. The debugger launch type is configured automatically based on your platform.
Platform
Requirements
Windows
Visual Studio 2017/2019/2022
Linux
gdb
OSX
lldb
Due to limitations with the debugger API it is not possible to update the test results when debugging.
