Modifying Automatically-Generated Test Cases

通常可以通过修改自动生成的测试用例来定义用户自定义测试用例。

修改现有测试用例的步骤：

1. 在测试用例浏览器或项目树中，找到 C++test 生成的测试套件文件。
   • 默认情况下，自动生成的测试类保存在被测试项目的 tests/autogenerated 目录中。
   • 要检查 C++test 将测试套件文件保存在哪里，可打开测试配置对话框，选择生成测试的测试运行所使用的测试配置，然后查看生成> 测试套件选项卡的测试套件输出文件和布局字段（详细信息请参阅自定义生成选项）。
2. 双击表示生成的测试类的项目树节点。生成的测试类文件将在编辑器中打开。
3. 根据需要修改测试用例。您可以...
   • 使用标准 C 或 C++ 代码、C/C++test API 文档中描述的宏、可用的测试函数中描述的例程以及测试用例后置条件宏中描述的后置条件。

• • • 内容辅助功能可帮助您添加宏和后置条件。例如，要添加后置条件模板，则键入CPPTEST_POST_CONDITION，将光标放在 N 后面，按下 Ctrl + 空格，然后选择所需的后置条件。要添加断言模板，则键入 CPPTEST_ASSERT，将光标放在 T 后面，按下 Ctrl + 空格，然后选择所需的断言。请务必自定义添加的模板。

• • 使用头文件中定义的包含指令和宏定义。
  • 使用 #include 指令构建测试可执行文件时，指示 C++test 包含额外的文件。包含的测试套件（用于自动生成的测试套件的测试套件类型）不需要包含任何头文件，除非使用的类型在原始被测源文件中不可见。例如，当您修改生成的测试以包含测试工厂等时，可能需要包含额外的头文件。
  • 通过更改 CPPTEST_CONTEXT 宏来更改测试套件上下文，该宏将给定的测试套件文件与指定的源文件相关联。只能指定一个源文件。如果未指定上下文，则每当执行项目时都会执行测试套件。
    • 如果在开始执行测试之前在项目树中选择了源文件或目录（例如源文件），C++test 将扫描在测试配置的测试搜索路径中指定的所有测试目录。将执行与所选上下文匹配的所有测试套件。
    • 如果选择了整个项目，则将执行测试路径上的所有测试套件。
    • 如果选择了测试套件或单个测试，则使用 CONTEXT 宏回溯到与该测试套件相关的源文件。只会仅执行选定的测试套件。

     4. 保存修改后的文件。