跳到主要内容

如何构建 Dora SSR 引擎

1. 获取项目源码​

git clone https://github.com/ippclub/Dora-SSR.git

2. 构建游戏引擎运行时​

  请选择你想要构建的目标平台。

本地桌面开发优先使用已有的 run_* 脚本，它们是最短的启动路径，并会检查必要的原生依赖产物；如果发现依赖缺失，会自动先构建完整依赖。Tools/build-scripts 下的平台依赖脚本会构建引擎需要的原生依赖，包括 SDL2、bgfx、Rust runtime 和 Wa 原生运行时。通常不需要再手动进入 Source/3rdParty/bgfx 单独构建 bgfx。

  1. 安装 Go 1.24 或更高版本、Rust、xmake，以及带有 MSBuild 工具的 Visual Studio Community 2026，与 Windows GitHub Actions 构建环境保持一致。

  2. 安装 MSYS2 和用于 Go cgo 构建 Wa 运行时 DLL 的 32 位 MinGW-w64 工具链。CI 使用 MSYS2 MINGW32；请在 MSYS2 MINGW32 shell 中执行：

    pacman -S --needed mingw-w64-i686-gcc

    请确保 MINGW32 的 gcc.exe 在其它 MinGW 工具链之前被找到。默认 MSYS2 安装路径下可以这样设置：

    set PATH=C:\msys64\mingw32\bin;%PATH%
    set CC=C:\msys64\mingw32\bin\gcc.exe

  3. 构建并运行本地 Debug 运行时。

    Tools\build-scripts\run_windows.bat

  4. 如果需要本地调试，可在 Visual Studio 中打开 Projects/Windows/Dora.sln，运行 Debug 配置。

3. 构建 Web IDE​

  1. 编译并运行 Dora SSR 引擎。

  2. 安装最新版的 Node.js 和 pnpm。

  3. 初始化 Dora Dora 编辑器。使用 pnpm start 进入开发模式。

    当需要让引擎运行时加载更新后的 Web IDE 时，再执行 pnpm build。它会生成生产版 Web IDE 静态文件，并同步到 Assets/www，引擎运行时会从这里提供 Web IDE 页面。

    请选择你的平台。

cd Tools/dora-dora && pnpm install
pnpm start
cd Tools/dora-dora
pnpm build

4. 引擎运行时和依赖构建流程​

run_macos.sh、run_windows.bat 和 run_linux.sh 是本地桌面开发的最短路径：它们会检查必要工具，确认 SDL2、bgfx 和 Wa 原生产物是否存在；如果任一必要产物缺失，会先构建完整依赖，然后重新构建 Rust runtime 和平台工程，停止已有 Dora 进程，并使用仓库里的 Assets 目录启动 Debug 运行时。

build_lib_* 脚本负责依赖构建。原生库缺失、过期，或者 CI 和发布流程需要重新准备依赖时，会使用这类脚本构建 SDL2、bgfx/bx/bimg、Wa 原生运行时和 Rust runtime。

平台 build_* 脚本是更高层的构建封装。它们会在合适的时候调用依赖构建步骤，在平台构建需要时刷新 Lua 绑定，然后通过 MSBuild、Xcode、Make 或 Gradle 等原生构建系统构建平台应用。