构建 Eglantine¶

[!WARNING] 在 MSYS2 上，使用 Qt Creator 时，建议另外从在线安装程序安装 Qt，并确保选择“MinGW”版本。

如果您没有通过项目导入工具克隆 Eglantine，请通过“文件 -> 打开文件或项目”（Ctrl+O）打开克隆目录中的 CMakeLists.txt 文件。

选择您想要的“套件”（通常默认即可）。推荐使用 RelWithDebInfo 或 Release：

点击“Configure Project”，然后等待 CMake 完成配置（在 Windows 上可能需要一些时间）。

[!WARNING] 对于所有系统：

• CMake必须在您的 PATH 中（如果您使用 ninja 作为 <GENERATOR>，ninja 也必须在 PATH 中）
• 您必须位于克隆的 Eglantine 目录中

在 Windows 上：

• 建议安装 Ninja
• 您必须加载 Visual C++ 开发环境，可以通过运行我们的便捷脚本完成：
• tools/windows/load-msvc-env.ps1（适用于 PowerShell 5+）
• tools/windows/load-msvc-env.sh（适用于 MSYS2、Git Bash 等）

可用的 <GENERATOR>：

• MSYS2：MSYS Makefiles
• MSVC：Ninja（首选）或 Visual Studio 17 2022
• macOS：Ninja（首选）或 Xcode
• 其他：Ninja（首选）或 UNIX Makefiles

可用的 <BUILD_TYPE>：

• Release（默认）
• RelWithDebInfo（包含调试符号——编译出的可执行文件会很大）
• Debug（如果您正在使用调试器，并且不想让内容被优化掉）

Debug 构建的注意事项：

• 如果您使用 CCache 构建，则需要添加环境变量 CL，并加上 /FS 标志（参考）

另请参阅根目录下的 CMakeLists.txt 以了解更多构建选项。不过通常默认设置会提供最佳体验。

cmake -S . -B build -G "<GENERATOR>" -DCMAKE_BUILD_TYPE=<BUILD_TYPE> -DYUZU_TESTS=OFF

如果您在 Windows 上并希望使用 Clang：

cmake -S . -B build -G "<GENERATOR>" -DCMAKE_C_COMPILER=clang-cl -DCMAKE_CXX_COMPILER=clang-cl

• 克隆仓库：

构建与设置¶

• 克隆完成后，您会进入类似下图的提示界面：

• 按下图所示进行设置：
• 更改：Build type: Release
• 更改：Name: Release
• 更改：Toolchain Visual Studio
• 更改：Generator: Let CMake decide
• 更改：Build directory: build

• 点击 OK；随后 CLion 会构建一个目录并为您的代码建立索引，以支持 IntelliSense。请耐心等待。
• 此过程完成后（右下角没有加载条），您现在就可以构建 Eglantine 了。
• 在右上角，单击下拉菜单，选择所有配置，然后选择 Eglantine。

• 现在点击播放按钮或按 Shift+F10 运行，Eglantine 将在构建完成后自动启动。

1. 从安装程序中为 Visual Studio 安装 "x64 Native Tools Command Prompt"，同时安装 cmake-gui。
2. 打开 "x64 Native Tools Command Prompt" 并输入 cmake-gui。
3. 点击 configure，选择 ninja generator > 指定本机编译器。
4. 将 "C:/Program Files/Microsoft Visual Studio/18/Community/VC/Tools/Llvm/x64/bin/clang-cl.exe" 作为您的 C/C++ 编译器路径。
5. 打开 Visual studio > Open project，或通过 Solution > Change 在克隆目录中搜索 CMake 项目文件（CMakeList.txt），然后构建。