Unity之六：项目实战篇

一、一个简单的实例

一个测试单元是源文件、测试文件和Unity构成的。把他们放在一起进行编译、链接，就可以得到一个可执行的测试文件了。

比如我们有一个简单的被测试文件DumbExample.c：

#include "DumbExample.h"

int8_t AverageThreeBytes(int8_t a, int8_t b, int8_t c)
{
	return (int8_t)(((int16_t)a + (int16_t)b + (int16_t)c) / 3);
}

对应的头文件如下：

#include <stdint.h>

int8_t AverageThreeBytes(int8_t a, int8_t b, int8_t c);

然后我们为其创建了一个测试文件TestDumbExample.c：

#include "unity.h"
#include "DumbExample.h"

void test_AverageThreeBytes_should_AverageMidRangeValues(void)
{
	TEST_ASSERT_EQUAL_HEX8(40, AverageThreeBytes(30, 40, 50));
	TEST_ASSERT_EQUAL_HEX8(40, AverageThreeBytes(10, 70, 40));
	TEST_ASSERT_EQUAL_HEX8(33, AverageThreeBytes(33, 33, 33));
}

void test_AverageThreeBytes_should_AverageHighValues(void)
{
	TEST_ASSERT_EQUAL_HEX8(80, AverageThreeBytes(70, 80, 90));
	TEST_ASSERT_EQUAL_HEX8(127, AverageThreeBytes(127, 127, 127));
	TEST_ASSERT_EQUAL_HEX8(84, AverageThreeBytes(0, 126, 126));
}

int main(void)
{
	UNITY_BEGIN();
	RUN_TEST(test_AverageThreeBytes_should_AverageMidRangeValues);
	RUN_TEST(test_AverageThreeBytes_should_AverageHighValues);
	return UNITY_END();
}

测试文件包含两个测试用例，每个测试用例由多个断言组成。如果其中某个断言执行失败，那么对应的测试用例就会失败，Unity应该运行所有的测试用例，然后输出一个完整的结果。

在Linux系统下，使用下面命令编译链接生成可执行测试文件TestDumbExample：

gcc TestDumbExample.c DumbExample.c ../unity/src/unity.c -I../unity/src/ -o TestDum