不倦的候鳥(niǎo)成長(zhǎng)日記

CxxTest使用指南（入門篇）

準(zhǔn)備工作：

1、 安裝perl/Python

2、 下載解壓CxxTest

3、 設(shè)置環(huán)境變量：

如果使用Perl,則設(shè)置一個(gè)名為PERL的環(huán)境變量，值為perl.exe的位置。（比如D:\Perl\Bin\Perl.exe）；

如果安裝Python,則設(shè)置一個(gè)名為PYTHON的環(huán)境變量，值為你安裝的Python目錄下的python.exe路徑（比如D:\Python25\python.exe）；

設(shè)置一個(gè)名為CXXTESTDIR 的環(huán)境變量，值為CxxTest解壓后的目錄。（比如D:\Cxxtest）。（設(shè)置CXXTESTDIR的原因：免去每次在makefile文件中指定CXXTESTDIR的目錄）

方式一：使用CxxTest \sample\msvc中的框架

1、 拷貝msvc文件夾到工程目錄中

打開(kāi)CxxTest_Workspace.sln，可以看到三個(gè)項(xiàng)目：

- CxxTest_3_Generate 運(yùn)行 cxxtestgen.pl 生成 runner.cpp 文件；

- CxxTest_2_Build 編譯生成的runner.cpp文件；

- CxxTest_1_Run 運(yùn)行測(cè)試；

2、 修改其中的makefile文件:

1）將以下內(nèi)容：

# Where to look for the tests

TESTS            = ..\gui\*.h ..\*.h

修改為：

# Where to look for the tests

TESTS            = *.h

這段話的作用是查找測(cè)試文件，我們的測(cè)試文件是.h格式的，放在當(dāng)前目錄下。（如果是.hpp格式的話，自然改成*.hpp；放在其它目錄的話，還要修改路徑）

2）將以下內(nèi)容刪除：

# Where the CxxTest distribution is unpacked

CXXTESTDIR       = ..\..

因?yàn)橄惹耙呀?jīng)定義了CXXTESTDIR的環(huán)境變量，這里的定義可以省掉。

3、 在CxxTest_3_Generate項(xiàng)目中添加測(cè)試文件

這是測(cè)試文件的一個(gè)簡(jiǎn)單的例子：

// Sampletest.h

#include <cxxtest/TestSuite.h>

//定義一個(gè)測(cè)試套件類，將測(cè)試用例放入其中

class SampletestSuite : public CxxTest::TestSuite   

{

public:

     //定義測(cè)試，以test作為測(cè)試函數(shù)前綴，

     //這是cxxtestgen.pl或cxxtestgen.py對(duì)測(cè)試文件進(jìn)行掃描，抽取測(cè)試用例的依據(jù)

     void testMultiplication( void )   

     {

         TS_ASSERT_EQUALS( 2 * 2, 5 );

     }

};

4、 運(yùn)行測(cè)試，即生成CxxTest_1_Run，可在輸出窗口看到測(cè)試結(jié)果，并雙擊結(jié)果行可定位到源代碼。

方法二：簡(jiǎn)化msvc，將Generate，Build，Run集成到一個(gè)項(xiàng)目中

1、 在工程中添加新項(xiàng)目：Unit_Test

將修改后的makefile文件拷貝到Unit_Test目錄中。

2、 在Unit_Test項(xiàng)目源文件中添加新建項(xiàng)dummy

無(wú)論添加進(jìn)來(lái)的是.cpp,還是.h,將后綴名去掉。

右擊dummy，選擇屬性，在彈出的屬性頁(yè)中，“自定義生成步驟”選項(xiàng)->“命令行”選項(xiàng)，輸入：

ECHO Don't Delete this file!!! > Dummy

ECHO -

ECHO -

ECHO -------------------- Generating test cases --------------------

if exist runner.cpp del runner.cpp /Q

NMAKE runner.cpp /nologo

ECHO -

ECHO –

在“輸出”選項(xiàng)中輸入：

Runner.cpp

Dummy只是一個(gè)文件，里邊可以是任何內(nèi)容，關(guān)鍵點(diǎn)在于對(duì)Dummy文件進(jìn)行編譯的時(shí)候所執(zhí)行的操作，這是一個(gè)批處理文件，這個(gè)批處理文件執(zhí)行生成 testcase 的操作，也就是調(diào)用Python/Perl生成測(cè)試用例（也就是runner.cpp文件）。為了保持每次編譯都可以生成新的runner文件，就必須保證

1）Dummy文件在runner.cpp之前進(jìn)行編譯；

2）Dummy文件每次都必須被重新編譯。 

第一點(diǎn)是通過(guò)文件順序來(lái)的，第二點(diǎn)是在生成事件里邊重新生成Dummy文件來(lái)保證的（VS2005似乎沒(méi)問(wèn)題，VC6似乎還是有些問(wèn)題的）。

從另外一個(gè)角度講，這個(gè)Dummy文件相當(dāng)于 samples/msvc 第一和第二個(gè)項(xiàng)目的功能。（即Generate和Build）

3、 編譯dummy文件，生成runner.cpp，將其添加到Unit_Test“源文件”中。

確定當(dāng)前目錄中已有.h測(cè)試文件，否則可能提示錯(cuò)誤。

4、 右擊Unit_Test，選擇屬性，在彈出來(lái)的屬性頁(yè)中， “生成事件”選項(xiàng)->“生成后事件”選項(xiàng)->“命令行”選項(xiàng)中輸入：

ECHO -

ECHO -

ECHO -------------------- Running Unit Test Cases --------------------

$(OutDir)\$(TargetName).exe

ECHO -

ECHO -

ECHO -------------------------------------------------------------------------------

DEL runner.cpp

放在項(xiàng)目“生成后事件”中的這一段命令，運(yùn)行生成的測(cè)試，相當(dāng)于samples/msvc 第三個(gè)項(xiàng)目的功能。（即Run）

5、 在Unit_Test“頭文件”中，添加新的.h測(cè)試文件。

生成Unit_Test，即可在輸出窗口分割線下看到運(yùn)行測(cè)試的結(jié)果，雙擊結(jié)果行可以定位到源代碼。

如：

1>-------------------- Running Unit Test Cases --------------------

1>Running 1 test

1>In MathsTestSuite::testMultiplication:

1>f:\test\cxxunittest\cxxunittest\sampletest.h(9): Error: Expected (2 * 2 == 5), found (4 != 5)

1>Failed 1 of 1 test

1>Success rate: 0%

1>----------------------------------------------------------------------------------

方法三：抽取出一個(gè)Unit_Test文件夾

所謂方法三，不過(guò)是將方法二中的Unit_Test文件夾，替代方法一中的msvc文件夾，移動(dòng)到其它的項(xiàng)目中使用而已。

不像方法一的msvc那樣需要三個(gè)項(xiàng)目，也不需像方法二那樣，每次都修改dummy，和項(xiàng)目屬性，添加命令行。將Unit_Test文件夾各個(gè)屬性都配置好之后，獨(dú)立出來(lái)隨時(shí)備用。

準(zhǔn)備工作，如前所言。

要進(jìn)行測(cè)試時(shí)：

將Unit_test文件夾拷貝放到工程目錄中，在工程中添加里面的Unit_Test項(xiàng)目，仿照Sampletest.h寫(xiě)自己的測(cè)試文件。

運(yùn)行測(cè)試時(shí)：