catch2/docs/vs/VS2012native-instructions.md

Creating managed tests in VS2012 is very similar to creating managed tests.

[pre-requisite - obviously, you'll also need Catch - my copy is in C:\Projects\Phil\Catch in the following examples...and I'm using the normal, multiple include files.]

## First, start by creating a new project

Choose 'File' ==> 'New' ==> 'Project' and choose a new Visual C++ Native Test project:
![VS2012 test project](VS2012native-test-project.png)

Now we need to change some build options, so right click the project and choose 'Properties':

There's no CLR option this time of course, but by default, Unicode will have been enabled - it is up to you whether to use Unicode or not - Catch will work with either setting.

Next, add Catch to the 'includes':

![VS2012 include options](VS2012native-options-include.png)

...and the wizard has correctly selected the debug runtime DLL.

## Now write a test

Next, delete the test code that the wizard provided in UnitTest1.cpp and write your own...


![VS2012 build example](VS2012native-example-build.png)

We can run this from the 'Test Explorer' but be sure to select the 'Traits' option from the drop down if you want to see the Catch TEST_CASE names:

![VS2012 example run](VS2012native-example-run.png)


Sadly, VS2012 is not as intuitive as VS2010; from here you have top open up the failing test to get the failure information:

![VS2012 example description](VS2012native-example-desc.png)

You can click the 'Output' link to see the output text:

![VS2012 example description](VS2012native-example-output.png)

Now if you click the link at the top of the stack trace "...unittest1.cpp: line 12" you get back to the problem:

![VS2012 example fail](VS2012native-example-fail.png)

And that's it!

## Creating a Catch console project

If you want to run Catch normally from the console, just create a new Windows Console app (you will need to turn off Unicode for this!) and add an additional .cpp file for `'main()'`.  I usually add a file called main.cpp, like this:

```
#define CATCH_CONFIG_MAIN
#include "catch.hpp"
``` 

---

[Home](../README.md)