干货分享 | TSMaster 测试报告生成器操作指南

用户在基于 TSMaster 软件开发测试用例时，或需要使用 TSMaster 生成 HTML 报告时，需要使用 TSMaster 测试报告生成器。

1、Test_Report 说明

Test_Report 是目前 TSMaster 为客户提供的一套测试报告模板，里面集成了测试报告的打印输出、图片展示、测试状态显示、测试通过率/失败率显示、以及执行时间显示为一体，测试报告示例如下图：

2、Test_Report 函数说明

1）test_init

函数名称	s32 test_init(const pnative_int Handle, const char* ReportName)
功能介绍	初始化测试报告生成器，并指定生成的 HTML 报告名称
调用位置	在执行其他函数之前需要先调用此函数进行初始化
输入参数	Handle :测试报告的句柄 ReportName: HTML 的报告名称
返回值	==0: 函数执行成功 其他值：函数执行失败
示例	native_int Handle = 0; Test_init(&Handle , “testReport”);

2）test_title

函数名称	s32 test_title(const native_int Handle, const char* testgroup, const char* testcase, const char* image, const char* testpurpose)
功能介绍	输入当前测试用例所属的测试用例组、测试用例名称及相关信息
调用位置	每个测试用例开始前调用此函数，用于标识测试用例组、测试用例名称，可以导入测试环境图片及测试目的和参考标准
输入参数	Handle ：测试报告的句柄 testgroup:：测试用例组名称 testcase：测试用例名称 image：测试环境图片，可以是任意图片,可为空 Testpurpose：测试目的以及测试参考标准，字符串，以英文逗号隔开,可为空
返回值	==0: 函数执行成功 其他值：函数执行失败
示例	native_int Handle = 0; s32 ret = Test_init(&Handle , “testReport”); if(ret == 0) { test_title(Handle ,”testgroup1”,”testcase1”,””,””); }

3）test_step

函数名称	s32 test_step(const native_int Handle, const char* teststep, const char* Description)
功能介绍	记录测试用例的具体步骤及描述
调用位置	每个测试用例的 test_title 函数之后调用
输入参数	Handle :测试报告的句柄 teststep: 测试步骤 Description:步骤描述，可以以英文逗号隔开，来输入期望结果与实际结果
返回值	==0: 函数执行成功 其他值：函数执行失败
示例	native_int Handle = 0; s32 ret = Test_init(&Handle , “testReport”); if(ret == 0) { test_title(Handle ,”testgroup1”,”testcase1”,””,””); test_step(Handle,”1”,”开始上电,上电成功,上电成功”); }

4）test_pass

函数名称	s32 test_pass(const native_int Handle, const char* teststep, const char* Description)
功能介绍	标记测试用例中的某一步骤为通过
调用位置	每个测试用例的 test_title 函数之后使用
输入参数	Handle :测试报告的句柄 teststep: 测试步骤 Description:步骤描述
返回值	==0: 函数执行成功 其他值：函数执行失败
示例	native_int Handle = 0; s32 ret = Test_init(&Handle , “testReport”); if(ret == 0) { test_title(Handle ,”testgroup1”,”testcase1”,””,””); test_step(Handle,”1”,”开始上电,上电成功,上电成功”); test_pass((Handle,”1”,”开始上电”); }

5）test_fail

函数名称	s32 test_fail(const native_int Handle, const char* teststep, const char* Description)
功能介绍	标记测试用例中的某一步骤为失败
调用位置	每个测试用例的 test_title 函数之后使用
输入参数	Handle :测试报告的句柄 teststep: 测试步骤 Description:步骤描述
返回值	==0: 函数执行成功 其他值：函数执行失败
示例	native_int Handle = 0; s32 ret = Test_init(&Handle , “testReport”); if(ret == 0) { test_title(Handle ,”testgroup1”,”testcase1”,””,””); test_step(Handle,”1”,”开始上电,上电成功,上电成功”); test_fail(Handle,”1”,”上电失败”); }

6）test_final

函数名称	s32 test_final(const native_int Handle)
功能介绍	结束测试报告生成，释放句柄并生成最终的 HTML 测试报告
调用位置	在所有测试用例执行完毕后调用
输入参数	Handle :试报告的句柄
返回值	==0: 函数执行成功 其他值：函数执行失败
示例	native_int Handle = 0; s32 ret = Test_init(&Handle , “testReport”); if(ret == 0) { test_title(Handle ,”testgroup1”,”testcase1”,””,””); test_step(Handle,”1”,”开始上电,上电成功,上电成功”); test_fail(Handle,”1”,”上电失败”); test_final(Handle); }