Source‐Engine‐(CN)

欢迎来到 Source Engine Wiki!

构建说明：

Linux:

Ubuntu 18.04 (bionic) / Debian 10 (buster)

准备工作

• 安装 git 并使用 git clone --recursive --depth 1 命令克隆此仓库。其中 --recursive 参数用于在克隆时初始化并更新子模块，--depth 1 参数用于仅克隆分支的最新提交。
• 使用 dpkg --add-architecture i386 命令向 dpkg 添加 i386 架构。
• 安装以下软件包：build-essential gcc-multilib g++-multilib pkg-config ccache。

必要依赖

• 对于 64 位系统，安装以下依赖：
  libsdl2-dev:i386 libfreetype6-dev:i386 libfontconfig1-dev:i386 libopenal-dev:i386 libjpeg-dev:i386 libpng-dev:i386 libcurl4-gnutls-dev:i386 libbz2-dev:i386 libedit-dev:i386。
• 你也可以用 libcurl4-openssl-dev 或 libcurl4-nss-dev 替代 libcurl4-gnutls-dev。

OPUS

• 如果需要语音聊天支持，请在 WAF 中添加 --enable-opus 参数，并按照以下步骤操作：
• 不要安装默认的 libopus-dev 软件包！ 默认版本的 opus 不支持自定义模式。
• 使用 git clone --recursive --depth 1 https://github.com/xiph/opus 命令克隆最新的 opus 源代码，并进入目录。
• 运行 sudo apt update; sudo apt install automake autoconf libtool 安装必要的工具。
• 对于 64 位系统，运行 export CFLAGS="-m32" CPPFLAGS="-m32"，这是构建 32 位引擎所需的步骤。
• 安装依赖后，运行 ./autogen.sh && ./configure --enable-custom-modes && make -j$(nproc) && sudo make install。
• 完成后可以继续构建引擎。

Arch Linux 及基于 Arch 的发行版

必要依赖

• 安装以下包：git python gcc gcc-multilib sdl2 freetype2 fontconfig zlib bzip2 libjpeg libpng curl openal opus。
• 对于 32 位支持，安装：lib32-gcc-libs lib32-sdl2 lib32-freetype2 lib32-fontconfig lib32-zlib lib32-bzip2 lib32-libjpeg lib32-libpng lib32-curl lib32-openal lib32-opus。
• 遵循 通用构建说明。

Windows

• 从 Visual Studio Installer 安装 MSVC 15.9 和 Windows SDK。或者直接安装完整版本的 Visual Studio 2017，使用其自带的 MSVC 15.9。
• 安装 Python 3 并添加到 Path。
• 构建只能在 PowerShell 中运行。
• 遵循 通用构建说明。

macOS

准备工作

• 从 App Store 安装 Xcode。
• 使用 xcode-select --install 命令安装 Xcode 构建工具。
• 安装 Homebrew。

必要依赖

• 使用以下命令安装依赖：
  brew install sdl2 freetype2 fontconfig pkg-config opus libpng libedit
• 遵循 通用构建说明。

BSD

FreeBSD

必要依赖

• 使用以下命令安装依赖：
  pkg ins python sdl2 freetype2 fontconfig curl pkgconf openal-soft jpeg-turbo png
• 遵循 通用构建说明。

通用构建说明（适用于所有操作系统）

• 使用 WAF 构建系统，需要安装 Python，推荐使用 Python 3。
• 运行 ./waf configure -T BUILDMODE，其中 BUILDMODE 可以是 release 或 debug。
• 在 Windows 系统上使用 .\waf.bat 或使用 python3 waf 来运行 WAF 脚本。
• 如果 WAF 提示类似 /usr/bin/env: 'python': No such file or directory 的错误，请在 ./waf 前加上 python3。
• 如果需要构建 64 位版本，请添加 -8 或 --64bits 参数。

专用服务器

• 在项目配置阶段添加 -d 参数即可。

Android（在 Linux 上)

准备工作

• 从 这里 下载并解压 Android NDK r10e。
• 从 CLANG 11 或 LLVM 仓库 下载并解压 CLANG 11（适用于 APT 系列发行版）。
• 运行以下命令设置环境变量：
  export ANDROID_NDK_HOME="路径/到/NDK/android-ndk-r10e"
export PATH="路径/到/CLANG/bin:$PATH" 或
  export PATH="/usr/lib/llvm-11/bin:$PATH"（如果使用 llvm.sh 脚本）。
• 在 WAF 参数中添加 --togles --android=aarch64,llvm,29。armeabi-v7a-hard 可替换为 aarch64 以构建 arm64 版本，但需要添加 -8 或 --64bits 参数。