This document explains how your Microsoft Visual C++ application can be modified to provide full debug information to BugSplat website when it crashes.

First steps

To begin Download and unzip the BugSplat software development kit for Microsoft Visual C++.

To get a feel for the BugSplat service before enabling your application, feel free to experiment with the myConsoleCrasher sample application. You can find the Visual Studio project file located in your download folder at ...\BugSplatNative\BugSplat\samples\myConsoleCrasher\myConsoleCrasher.vcxproj.

Run the sample application without the debugger attached to post a sample crash report to our public database.

You may also want to browse the BugSplat Native API documentation.

Generating crash reports with your application

Add BugSplat to your application using the following steps:

You should modify your build settings so that symbol files are created for release builds, e.g.,

MyConsoleCrasher property pages image one for BugSplat crash reporting with C++ MyConsoleCrasher property pages image two for BugSplat crash reporting with C++

Note: To get fully detailed call stacks and variable names for each crash on the BugSplat website, every time you build a release version of your application for distribution or internal testing, you should upload all .exe, .dll, and .pdb files for your product on the Symbols Page. Better yet, use the SendPdbs application as part of your build process to automate symbol upload to BugSplat.

Test your application by forcing a crash and verifying that the BugSplat dialog appears and that crashes are posted to your BugSplat account.

Finally, make sure to check that symbol names in the call stack are resolved correctly. If they aren’t, double-check that the correct version of symbol files and all executables for your application have been uploaded on the Symbols page.

Toolset Considerations

MyConsoleCrasher targets the v120_xp toolset which is not installed by later versions of Visual Studio. To build MyConsoleCrasher you may need to update the project's toolset and platform version.

The following steps are for Visual Studio 2017, other versions of Visual Studio may require slightly different steps.

To update your project's toolset and platform version, right click your project in Visual Studio, then choose Properties. In the properties menu, change "Platform Toolset" to a version available in your environment and click OK to save your changes.

C++ Visual Studio Platform Toolset

Close the properties menu and right click the project again. This time choose the option to "Retarget Projects". Choose Windows SDK Version 10.* and click OK. You should now be able to build MyConsoleCrasher.

C++ Visual Studio Retarget Projects

Further options

Instructions for modifying the default crash dialog can be found on the Windows Dialog Box page.


See technology dependencies at our dependencies page.