如何在VS2013中进行Boost单元测试

　　对于如何在VS2013中进行Boost单元测试，这方面资料太少。自己也因此走了不少弯路。下文将会阐述一下如何在VS2013中进行Boost单元测试。

　　在开始Boost单元测试之前，我们需要先安装VS2013插件Boost Unit Test Adapter (Update 3) 以及编译Boost库。Boost Unit Test Adapte可以在VS2013中的“工具->扩展与更新”中找到并安装。对于Boost Unit Test Adapter所支持的Boost库版本请参考网页。我选择的是版本号为1.55.0的Boost库（可以在其官网下载得到）。在编译Boost库的时候，可以参考教程及博文。我选择的是完全编译（bjam --toolset=msvc-12.0 --build-type=complete）。

　　下文以几个步骤来阐述：

　  1. 新建解决方案及工程

　　接下来，我们新建一个BoostUnitTest解决方案，然后在该方案下添加(鼠标右击解决方案新建项目)两个项目。第一个项目是空的“WIN32”项目“Tested”，另一个是“Boost Unit Test Project”项目（新建项目->模板->Visual C++->Test下）“BoostUnitTest”。如下图：

　　

　  2. 在被测试工程中添加文件

　　在Tested工程中添加一个头文件tested.h及源文件tested.cpp. 具体代码如下

 #include <iostream>

 using namespace std;

 class Tested
 {
 public:

     Tested();
     virtual ~Tested();
     int add(const int a, const int b);

 private:

 };

tested.h

 #include "tested.h"

 Tested::Tested()
 {

 }

 Tested::~Tested()
 {

 }

 int Tested::add(const int a, const int b)
 {
     return a + b;
 }

tested.cpp

　　在这里，我们并不需要新建一个main函数对这个类tested进行测试（因为我们已经有单元测试了），但一个程序默认是需要main函数的，所以在需要在Tested项目属性中进行这样的设置（“配置类型”改为“动态库(.dll)”见下图）：

　　

　　接着，“生成”该工程，产生tested.obj文件。

　  3. 配置Boost单元测试工程

　　新建的Boost单元测试工程中有两个源文件“BoostUnitTestSample.cpp”及“BoostUnitTest.cpp”（还有stdafx.h、stdafx.cpp、targetver.h），前一个文件是样例，可以不要，后一个文件可以当作我们的单元测试源文件。

　　先对该工程进行配置：

　　1）添加“平台工具集”为"Visual Studio 2013 (v120)"，见下图：

　　

　　2）添加包含Boost库的根目录（在我电脑上是D:\boots_1_55_0），见下图：

　　

　　3）添加Boost库目录及待测试工程的.obj文件所在目录，见下图：

　　

　　4）添加“附加依赖项”“tested.obj”，见下图：

　　

　  4. 进行Boost单元测试

　　注：我们在这时只进行简单的单元测试，更加复杂的测试请参考文章最后给出的链接。　　

　　在BoostUnitTest工程中的文件“BoostUnitTest.cpp”（也可新建）添加如下代码：

 #define BOOST_TEST_MODULE Tested_Module                                // 主测试套件，一个测试项目中只能有一个主测试套件

 #include "stdafx.h"
 #include "D:\VSProject\BoostUnitTest\BoostUnitTest\Tested\tested.h"    // 待测工程头文件

 struct Tested_Fixture                                                  // 测试夹具
 {
     Tested_Fixture()
     {
         BOOST_TEST_MESSAGE("setup fixture");
         tmpTested = new Tested();
     }
     ~Tested_Fixture()
     {
         BOOST_TEST_MESSAGE("teardown fixture");
         delete tmpTested;
     }
     Tested * tmpTested;
 };

 BOOST_FIXTURE_TEST_SUITE(Tested_test, Tested_Fixture)                  // 测试套件

 BOOST_AUTO_TEST_CASE( Tested_Method_add_Test)                          // 测试用例
 {
      // TODO: Your test code here
     BOOST_WARN(tmpTested->add(, ) == );                             // WARN型预言检测
     BOOST_CHECK(tmpTested->add(, ) == );                            // CHECK型预言检测
     BOOST_REQUIRE(tmpTested->add(, ) == );                          // REQUIRE型预言检测
 }

 BOOST_AUTO_TEST_SUITE_END()

　　点击“生成->生成解决方案”（预先打开“测试->窗口->测试资源管理器”）可以看到在“测试资源管理器”中出现了“BoostUnitTest”这个单元测试用例，如下图：

　　注：如果电脑安装有杀毒软件（如360），“生成解决方案”的时候可能会提示：error LNK1104: 无法打开文件“...\BoostUnitTest\Debug\Tested.dll"。这是因为杀毒软件拦截了单元测试工程对被测试工程.dll文件的访问。比较简单的方法是将杀毒软件关闭就OK了。

　　

　　点击“全部运行”，可以看到该测试用例变绿，说明测试通过，如下图：

　　

　　如果我们将“BoostUnitTest.cpp”中的第13行改成：

BOOST_CHECK(tmpTested->add(, ) == );

　　单元测试运行结果是不通过，如下图：

　　

　　至此，如何进行一个简单的Boost单元测试的过程就完成了。

　　// 添加于2014.10.18 ---------------------------------------------------------------------------

　　现在，我在之前程序的基础上又添加了一点异常测试，相关的源代码如下：

 #include <iostream>

 using namespace std;

 class Tested
 {
 public:

     Tested();
     virtual ~Tested();
     int add(const int a, const int b);
     void testException();

 private:

 };

tested.h

 #include "tested.h"

 Tested::Tested()
 {

 }

 Tested::~Tested()
 {

 }

 int Tested::add(const int a, const int b)
 {
     return a + b;
 }

 void Tested::testException()
 {
     throw logic_error("my throw");    // 抛出一个逻辑错误异常
 }

tested.cpp

 #define BOOST_TEST_MODULE Tested_Module                                // 主测试套件，一个测试项目中只能有一个主测试套件

 #include "stdafx.h"
 #include "D:\VSProject\BoostUnitTest\BoostUnitTest\Tested\tested.h"    // 待测工程头文件

 struct Tested_Fixture                                                // 测试夹具
 {
     Tested_Fixture()
     {
         BOOST_TEST_MESSAGE("setup fixture");
         tmpTested = new Tested();
     }
     ~Tested_Fixture()
     {
         BOOST_TEST_MESSAGE("teardown fixture");
         delete tmpTested;
     }
     Tested * tmpTested;
 };

 BOOST_FIXTURE_TEST_SUITE(Tested_test, Tested_Fixture)                // 测试套件

 BOOST_AUTO_TEST_CASE(Tested_Method_add_Test)                        // 测试用例
 {
      // TODO: Your test code here
     BOOST_WARN(tmpTested->add(, ) == );                            // WARN型预言检测
     BOOST_CHECK(tmpTested->add(, ) == );                            // CHECK型预言检测
     BOOST_REQUIRE(tmpTested->add(, ) == );                        // REQUIRE型预言检测

 }

 BOOST_AUTO_TEST_CASE(Tested_Method_testException_Test)                // 测试用例
 {
     // TODO: Your test code here
     BOOST_REQUIRE_NO_THROW(tmpTested->testException());                // 验证是否无异常抛出，是则为真
     BOOST_REQUIRE_THROW(tmpTested->testException(), logic_error);    // 验证抛出的是否是logic_error异常
     BOOST_REQUIRE_THROW(tmpTested->testException(), runtime_error);    // 验证抛出的是否是runtime_error异常

 }

 BOOST_AUTO_TEST_SUITE_END()

BoostUnitTest.cpp

　　很显示，程序的运行结果如下：

 BOOST_REQUIRE_NO_THROW(tmpTested->testException());              // 测试不通过
 BOOST_REQUIRE_THROW(tmpTested->testException(), logic_error);    // 测试通过
 BOOST_REQUIRE_THROW(tmpTested->testException(), runtime_error);  // 测试不通过

　　如果要进行更复杂的测试，可以参考官方文档。

　　还有一些个人觉得比较好的参考资料：

　　Boost Test Library 中文手册；

　　DeveloperWorks的“了解Boost单元测试框架”；

　　博文“单元测试分享”；

　　博文“Boost学习总结（C++）”；

　　博文“面向C++的测试驱动开发”。

　　连载“单元测试实践的主要问题与解决”。