# 如何构建

## 如何构建：环境

```{important}
构建和使用 Dagor Engine 工具包的要求：
- Windows 10 (x64)
- 16 GB of RAM
- 200 GB of HDD/SSD space
```

1. 安装 Git: <https://git-scm.com/download/win>.

2. 安装 7-Zip: <https://www.7-zip.org/>.

3. 安装 Python 3.

4. 如果您打算使用 FMOD 声音库，请同时安装 FMOD Studio SDK 2.02.15。

5. 在任何驱动器的根目录下创建一个项目目录。

   ```{note}
   目录名称不应包含空格或非拉丁字符。
   ```

   ```text
   md X:\develop
   cd X:\develop
   ```

6. 克隆 Dagor Engine 源代码和示例：

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

7. 运行 `make_devtools.py` 脚本。

   此脚本将下载、安装和配置 build toolkit。您应该提供 build toolkit 目录的路径作为参数，如果该目录不存在，脚本将创建该目录。

   ```text
   python3 make_devtools.py X:\develop\devtools
   ```

   ```{importnat}
   - 如果脚本不是以管理员身份运行，则某些程序的安装程序可能会请求安装权限，您应该授予该权限。
   - 如果您计划使用 3ds Max 插件，请在脚本询问是否要安装 3ds Max SDK 时按`Y`。
   - 该脚本还将要求将路径 `X:\develop\devtools` 添加到 `PATH` 环境变量中，并将 `GDEVTOOL` 变量设置为指向此目录。
   ```

   脚本完成工作后，`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 的替代品

8. 重新启动命令行控制台以使新的环境变量可用。

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

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

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

目录结构应如下所示：

```text
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/`: 构建后放置资产和游戏可执行文件所在的目录。

  ```{seealso}
  有关更多信息，请参阅
  [目录结构概述](directory_structure.md).
  ```

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

要构建 **testGI** 示例：

1. 导航到`X:\develop\DagorEngine\samples\testGI\prog`目录。

2. 运行`jam` 命令。

   构建完成后，可执行文件将放置在`testGI\game`目录中。

3. 运行`DagorEngine/build_all.cmd`从源代码构建整个项目工具包。此过程可能需要相当长的时间。