TestAdapter_Catch2 项目使用教程

1. 项目目录结构及介绍

TestAdapter_Catch2 是一个用于 Visual Studio 的测试适配器，支持 Catch2 C++ 测试框架。项目的目录结构如下：

TestAdapter_Catch2/
├── Docs/
│   ├── README.md
│   └── ...
├── Libraries/
│   └── ...
├── ReferenceTests/
│   └── ...
├── ReferenceTests_v3/
│   └── ...
├── UnitTests/
│   └── UT_Catch2Interface/
│       └── ...
├── VSIX/
│   └── VSTestAdapterCatch2/
│       └── ...
├── .gitattributes
├── .gitignore
├── LICENSE
├── README.md
├── VSTestAdapterCatch2.runsettings
└── VSTestAdapterCatch2.sln

目录结构介绍

• Docs/: 包含项目的文档文件，如 README.md。
• Libraries/: 包含项目依赖的库文件。
• ReferenceTests/: 包含项目的参考测试文件。
• ReferenceTests_v3/: 包含项目参考测试文件的 v3 版本。
• UnitTests/: 包含项目的单元测试文件，特别是 UT_Catch2Interface 目录下的测试文件。
• VSIX/: 包含 Visual Studio 扩展的相关文件，特别是 VSTestAdapterCatch2 目录下的文件。
• .gitattributes: Git 属性配置文件。
• .gitignore: Git 忽略配置文件。
• LICENSE: 项目许可证文件。
• README.md: 项目介绍和使用说明文件。
• VSTestAdapterCatch2.runsettings: 项目的运行设置文件。
• VSTestAdapterCatch2.sln: 项目的解决方案文件。

2. 项目启动文件介绍

项目的启动文件是 VSTestAdapterCatch2.sln，这是一个 Visual Studio 解决方案文件。通过打开这个文件，可以在 Visual Studio 中加载整个项目，并进行编译、测试和调试。

启动步骤

1. 打开 Visual Studio。
2. 选择“文件” -> “打开” -> “项目/解决方案”。
3. 导航到 TestAdapter_Catch2 目录，选择 VSTestAdapterCatch2.sln 文件并打开。
4. 等待 Visual Studio 加载解决方案和所有相关项目。
5. 在解决方案资源管理器中，选择需要运行的项目或测试，右键点击并选择“运行”或“调试”。

3. 项目配置文件介绍

项目的配置文件主要是 VSTestAdapterCatch2.runsettings，这是一个用于配置测试运行的设置文件。该文件通常包含以下内容：

<RunSettings>
  <!-- 配置 Catch2 测试适配器的设置 -->
  <Catch2Adapter>
    <Settings>
      <!-- 配置 Catch2 测试适配器的具体设置 -->
    </Settings>
  </Catch2Adapter>
</RunSettings>

配置文件介绍

• RunSettings: 根元素，包含所有测试运行的设置。
• Catch2Adapter: 配置 Catch2 测试适配器的元素。
• Settings: 包含 Catch2 测试适配器的具体设置，如测试发现路径、测试执行参数等。

配置步骤

1. 打开 VSTestAdapterCatch2.runsettings 文件。
2. 根据需要修改配置项。例如，可以指定测试发现的路径或添加特定的测试执行参数。
3. 保存文件。
4. 在 Visual Studio 中，选择“测试” -> “测试设置” -> “选择测试设置文件”，选择 VSTestAdapterCatch2.runsettings 文件。
5. 运行测试时，Visual Studio 将使用该配置文件中的设置。

通过以上步骤，您可以成功配置和使用 TestAdapter_Catch2 项目。