由于项目需要,对于C语言的单元测试工具CUnit在Linux下如何使用进行了调查,在网上对相关内容进行搜索发现,很多内容都很相近,甚至完全一样,在这篇争相转载的文章中,虽有详细的说明,但也有描述的不甚清晰之处,对于刚刚接触Linux的同学,往往是一头雾水,不能很顺利的配置出来。籍着此次的调查机会,现将具体的步骤和配置过程中需要注意的地方进行了补充说明,希望能对以后需要进行同样工作的同学有些帮助。
1、首先在http://cunit.sourceforge.net/index.html链接处,下载最新版本的CUnit源码包(CUnit-2.1-0-src.tar.gz)。
2、将CUnit源码包(CUnit-2.1-0-src.tar.gz)复制到Linux的目标目录下,比如我在这里放到了/usr/unittest目录下。
3、CUnit源码包的解压。打开[System Tools]-〉[Terminal],进入到/usr/unittest目录下,
输入如下命令:
#tar xzvf CUnit-2.1-0-src.tar.gz
执行结束后,将会在当前目录下生成一个解压后的文件夹(CUnit-2.1-0)。
4、解压结束后,开始进行编译和安装。
#cd CUnit-2.1-0
#aclocal
#autoconf
#automake
#chmod u+x configure
#./configure --prefix
(对上一句进行解释,这个位置,需要你输入要安装的目录,目录的格式举例如下:/usr/unittest/)
#make
#make install
这里需要一段时间...
#cd /usr/unittest/lib
#ldconfig
最后这两句,感觉像是没什么用,有时间证实一下。
到此处为止,CUnit的安装基本上就到一段落了。
接下来是来测试我们的代码工作流程。
将要测试的代码复制到/usr/unittest目录下,
输入如下命令:
#export LD_LIBRARY_PATH=/usr/unittest/lib
#gcc -o test -I/usr/unittest/include -L/usr/unittest/lib -lcunit run_test.c test_func.c func.c
这样,即可在/usr/unittest目录下生成可执行文件test。
#./test
执行该文件,执行成功后,会在当前目录下产生两个xml文件。
①TestMax-Listing.xml :对测试用例的报告
②TestMax-Results.xml :对测试结果的报告
要查看这两个文件,还需要使用如下xsl和dtd文件:
CUnit-List.dtd和CUnit-List.xsl用于解析列表文件,
CUnit-Run.dtd和CUnit-Run.xsl用于解析结果文件。
这四个文件在CUnit包里面有提供,安装之后在unittest/share/CUnit目录下,
默认安装的话在/home/usr/local/share/CUnit目录下。
在查看结果之前,需要把这六个文件:
TestMax-Listing.xml, TestMax-Results.xml, CUnit-List.dtd, CUnit-List.xsl, CUnit-Run.dtd, CUnit-Run.xsl拷贝到一个目录下,然后用浏览器打开两个结果的xml文件就可以了。
-------------------------------------------------- 示例代码如下: func.c -------- int maxi(int i, int j) { return i>j?i:j; // return i; } -------- test_func.c -------- #include #include #include #include "include/CUnit/CUnit.h" #include "include/CUnit/Automated.h" /**//*---- functions to be tested ------*/ extern int maxi(int i, int j); /**//*---- test cases ------------------*/ void testIQJ() { CU_ASSERT_EQUAL(maxi(1,1),1); CU_ASSERT_EQUAL(maxi(0,-0),0); } void testIGJ() { CU_ASSERT_EQUAL(maxi(2,1),2); CU_ASSERT_EQUAL(maxi(0,-1),0); CU_ASSERT_EQUAL(maxi(-1,-2),-1); } void testILJ() { CU_ASSERT_EQUAL(maxi(1,2),2); CU_ASSERT_EQUAL(maxi(-1,0),0); CU_ASSERT_EQUAL(maxi(-2,-1),-1); } CU_TestInfo testcases[] = { {"Testing i equals j:", testIQJ}, {"Testing i greater than j:", testIGJ}, {"Testing i less than j:", testILJ}, CU_TEST_INFO_NULL }; /**//*---- test suites ------------------*/ int suite_success_init(void) { return 0; } int suite_success_clean(void) { return 0; } CU_SuiteInfo suites[] = { {"Testing the function maxi:", suite_success_init, suite_success_clean, testcases}, CU_SUITE_INFO_NULL }; /**//*---- setting enviroment -----------*/ void AddTests(void) { assert(NULL != CU_get_registry()); assert(!CU_is_test_running()); /**//* shortcut regitry */ if(CUE_SUCCESS != CU_register_suites(suites)){ fprintf(stderr, "Register suites failed - %s ", CU_get_error_msg()); exit(EXIT_FAILURE); } } -------- run_test.c -------- #include #include #include int main( int argc, char *argv[] ) { printf("hello"); if(CU_initialize_registry()){ fprintf(stderr, " Initialization of Test Registry failed. "); exit(EXIT_FAILURE); }else{ AddTests(); CU_set_output_filename("TestMax"); CU_list_tests_to_file(); CU_automated_run_tests(); CU_cleanup_registry(); } return 0; } -----------------------end--------------------------------