CppUnitTestFramework Test Adapter
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.
