自动化测试工具Parasoft C/C++ test 自动化用户指南（二十三）：用测试开始和停止信息对结果进行注释

翻译|使用教程|编辑：李显亮|2021-07-26 10:06:46.710|阅读 745 次

概述：在parasoft中，我们可以使用测试开始/停止信息注释代码覆盖率结果，以了解特定测试场景如何影响代码执行。测试开始通知传达有关测试名称的信息，可在处理测试数据和生成报告时使用。

# 慧都年终大促·界面/图表报表/文档/IDE等千款热门软控件火热促销中 >>

使用测试启动/停止 API

API包括以下功能：

void CDECL_CALL CppTest_TestStart(const char* testName) - 向结果流发送关于具有指定名称的测试开始的通知
void CDECL_CALL CppTest_TestStop(void) - 向结果流发送关于先前开始的测试结束的通知。

在将调用 API 函数的源文件中包含一个专用的头文件：

#include "cpptest/cpptest.h"

编译源文件时使用-I选项指定cpptest.h头文件位置：

-I <Installation Directory>/runtime/include

指定一个有效的字符串作为CppTest_TestStart function. 空指针或无效字符串将导致未定义的行为。

测试启动/停止场景的常见应用

以下场景说明了测试启动/停止通知 API 的用法。

使用单元测试用例名称注释覆盖结果

在这种情况下，单元测试用例名称用作指定给CppTest_TestStart函数调用的参数。对于一些流行的 C/C++ 单元测试框架，提供了专用连接器来自动执行此任务。
要使用没有专用连接器的单元测试框架，您可以在测试用例的开头和结尾调用启动/停止 API 函数：

				
										#include "cpptest/cpptest.h" 
									
										TEST(TimerTest, smokeTest) { 
									
										  const char * tcName = testCaseName(); 
									
										  CppTest_TestStart(tcName); 
									
										  int res = init_timer(); 
									
										  ASSERT_TRUE(res != 0); 
									
										  CppTest_TestStop(); 
									
										}

使用系统测试会话的手动测试场景名称注释覆盖结果

有几种方法可以实现这个目标：

对测试启动/停止 API 的调用可以直接添加到测试源。它们可以在被测试应用程序的调试或测试版本中使用专用宏激活。向 API 函数调用提供测试场景名称的方法取决于应用程序的类型。在某些情况下，您可以向测试应用程序的菜单添加一个特殊选项，该选项仅在调试版本或命令行中可见。这将使您能够指定执行的测试场景的名称，并在输入名称后将通知发送到结果流。
在启动测试应用程序之前，还可以从环境变量集中读取测试用例的名称。
使用作为独立线程实现的特殊模块，该线程与测试应用程序的线程并行启动。例如，该模块可以侦听 TCP/IP 套接字，并在从外部工具发送测试启动/停止命令时做出反应。