如何构建

如何构建：环境

Important

构建和使用 Dagor Engine 工具包的要求：

Windows 10 (x64)
16 GB of RAM
200 GB of HDD/SSD space

安装 Git: https://git-scm.com/download/win.
安装 7-Zip: https://www.7-zip.org/.
安装 Python 3.
如果您打算使用 FMOD 声音库，请同时安装 FMOD Studio SDK 2.02.15。
在任何驱动器的根目录下创建一个项目目录。

Note

目录名称不应包含空格或非拉丁字符。
```
md X:\develop
cd X:\develop
```

克隆 Dagor Engine 源代码和示例：

git clone https://github.com/GaijinEntertainment/DagorEngine.git
cd DagorEngine

运行 make_devtools.py 脚本。

此脚本将下载、安装和配置 build toolkit。您应该提供 build toolkit 目录的路径作为参数，如果该目录不存在，脚本将创建该目录。
```
python3 make_devtools.py X:\develop\devtools
```
脚本完成工作后，X:\develop\devtools 目录将配置以下 SDK 和工具：
- FidelityFX_SC: 用于图像质量增强的库
- fmod-studio-2.xx.xx [optional]: FMOD 音频库
- LLVM-15.0.7: C/C++ 编译器和库 (Clang)
- nasm: 汇编语言
- max2024.sdk: 3ds Max 2004 SDK
- openxr-1.0.16: AR/VR库
- vc2019_16.10.3: C/C++ 编译器和库 (MSVC)
- win.sdk.100: Windows 10 SDK
- win.sdk.81: Windows 8.1 SDK
- ducible.exe: 一种使可移植可执行文件（PE）和 PDB 的构建可重现的工具
- pdbdump.exe: 用于转储 PDB 文件内容的工具
- jam.exe: 一个小型构建工具，可以用作 Make 的替代品
重新启动命令行控制台以使新的环境变量可用。

如何构建：预构建的二进制文件

从存储库https://github.com/GaijinEntertainment/DagorEngine/releases下载并提取其他二进制文件到X:\develop\DagorEngine目录中：

samples-base.7z: 包含初始资源，这些资源将被编译成二进制文件，这些二进制文件将加载到游戏中。
samples-prebuilt-game.7z: 包含预编译的资产。
tools-prebuilt.7z: 包含预构建的 Engine Toolkit。

目录结构应如下所示：

X:\develop\DagorEngine\tools\...

X:\develop\DagorEngine\samples\skiesSample\game
                              \skiesSample\develop
                              \skiesSample\prog

X:\develop\DagorEngine\samples\testGI\game
                              \testGI\develop
                              \testGI\prog

其中

prog/: 包含游戏源代码。
develop/: 包含初始资产。
game/: 构建后放置资产和游戏可执行文件所在的目录。

See also

有关更多信息，请参阅目录结构概述.

如何构建：从源代码构建

要构建 testGI 示例：

导航到X:\develop\DagorEngine\samples\testGI\prog目录。
运行jam 命令。

构建完成后，可执行文件将放置在testGI\game目录中。
运行DagorEngine/build_all.cmd从源代码构建整个项目工具包。此过程可能需要相当长的时间。