catch2/docs/vs/VS2012native-instructions.md
2013-11-17 16:36:08 +00:00

59 lines
2.1 KiB
Markdown

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
[Note that it is best to put your tests in a namespace for those tests, as described here!](vs-index.md)
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)