Cucumber-CPP 技术文档

1. 安装指南

Cucumber-CPP 是一个允许使用 C++ 编写步骤定义的库。以下是安装 Cucumber-CPP 的步骤：

依赖性

Cucumber-CPP 依赖于以下可执行文件和库：

• cmake 3.16 或更高版本。用于设置环境和构建软件。
• Asio 1.18.1 或更高版本。
• Boost.Test 1.70（可选，用于 Boost 测试驱动程序）。
• GTest 1.11.0 或更高版本（可选，用于 GTest 驱动程序）。
• GMock 1.11.0 或更高版本（可选，用于内部测试套件）。
• nlohmann-json 3.10.5 或更高版本。
• Qt6 或 Qt5（可选，用于 CalcQt 示例和 QtTest 驱动程序）。
• TCLAP 1.2.5 或更高版本。

为了安装 Ruby 预先条件：

gem install bundler  // 对于 Windows：gem install bundle
bundle install

Windows 与 Linux

为了在特定的系统（Windows 或 Linux）上设置依赖项，可以查看 Windows 和 Linux 的工作流文件以获取灵感。

2. 项目的使用说明

安装完所有依赖后，你可以通过以下步骤构建和运行 Cucumber-CPP。

构建步骤

构建 Cucumber-CPP，包括测试和示例：

# 创建构建目录
cmake -E make_directory build

# 生成 Makefile
cmake -E chdir build cmake \
    -DCUKE_ENABLE_BOOST_TEST=on \
    -DCUKE_ENABLE_GTEST=on \
    -DCUKE_ENABLE_QT_6=on \
    -DCUKE_TESTS_UNIT=on \
    -DCUKE_ENABLE_EXAMPLES=on \
    ..

# 构建 cucumber-cpp
cmake --build build

# 运行单元测试
cmake --build build --target test

# 运行安装
cmake --install build

运行示例

Unix 系统上的 Calc 示例

build/examples/Calc/BoostCalculatorSteps >/dev/null &
(cd examples/Calc; cucumber)

Windows 系统上的 Calc 示例（NMake）

start build\examples\Calc\BoostCalculatorSteps.exe
cucumber examples\Calc

3. 项目 API 使用文档

Cucumber-CPP 使用线缆协议与 Cucumber-Ruby 进行通信。你需要确保 Cucumber-Ruby 已经安装在系统路径上。关于 Cucumber-CPP 的详细 API 文档，请参考官方 GitHub Wiki。

4. 项目安装方式

Cucumber-CPP 可以通过以下方式安装：

• 通过源代码下载和构建。
• 使用包管理器（如果支持的话）。

确保你已经安装了所有必要的依赖项，并按照上述构建步骤进行操作。

通过上述内容，你应该能够成功地安装和使用 Cucumber-CPP，并开始编写 C++ 的步骤定义。如果遇到任何问题，请参考官方文档或在社区讨论组中提问。