如何构建 Dora SSR 引擎

1. 获取项目源码

GitHub

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

Gitee

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

GitCode

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

2. 构建游戏引擎运行时

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

Windows

1. 安装 Rust 语言环境。

2. 执行下面的脚本，生成引擎的依赖库。

   Tools\build-scripts\build_lib_windows.bat

3. 安装 Visual Studio Community 2022。

4. 在 IDE 中打开工程文件：Projects/Windows/Dora.sln。

5. 进行编译. 调试和运行。

macOS

1. 安装 Rust 语言环境。

2. 执行下面的脚本，生成引擎的依赖库。

   Tools/build-scripts/build_lib_macos.sh

3. 安装最新版 Xcode。

4. 在 IDE 中打开工程文件：Projects/macOS/Dora.xcodeproj。

5. 进行编译. 调试和运行。

iOS

1. 安装 Rust 语言环境。

2. 执行下面的脚本，生成引擎的依赖库。

   Tools/build-scripts/build_lib_ios.sh

3. 安装最新版 Xcode。

4. 在 IDE 中打开工程文件：Projects/iOS/Dora.xcodeproj。

5. 进行编译. 调试和运行。

Android

1. 安装 Rust 语言环境。

2. 执行下面的脚本，生成引擎的依赖库。

   Tools/build-scripts/build_lib_android.sh

3. 手动生成 Lua 绑定。

   # 在 Ubuntu 系统上构建
   sudo apt-get install lua5.1
   sudo apt-get install -y luarocks
   sudo luarocks install luafilesystem
   cd Tools/tolua++
   lua tolua++.lua
   
   # 在 macOS 系统上构建
   cd Tools/tolua++
   ./build.sh
   
   # 在 Windows 系统上构建
   cd Tools\tolua++
   build.bat

4. 安装最新版 Android Studio。

5. 在 IDE 打开工程目录：Projects/Android/Dora。

6. 进行编译. 调试和运行。

Linux

1. 安装 Rust 语言环境。

2. 执行下面的脚本，生成引擎的依赖库。

   在 x86_64 架构上

   Tools/build-scripts/build_lib_linux_x86_64.sh

   在 ARM64 架构上

   Tools/build-scripts/build_lib_linux_aarch64.sh

Ubuntu/Debian

3. 安装依赖包。

   sudo apt-get install -y libsdl2-dev libgl1-mesa-dev libssl-dev

4. 手动生成 Lua 绑定。

   sudo apt-get install lua5.1
   sudo apt-get install -y luarocks
   sudo luarocks install luafilesystem
   cd Tools/tolua++
   lua tolua++.lua

Arch Linux

3. 安装依赖包。

   sudo pacman -S lua51 luarocks sdl2 openssl gcc make cmake --needed
   # 因为lua的版本必须是5.1,你需要使用lua5.1而不是最新的lua
   # 最简单的方法是用ln创建一个软链接
   sudo ln -s /usr/bin/lua5.1 /usr/local/bin/lua

4. 手动生成 Lua 绑定。

   sudo luarocks --lua-version 5.1 install luafilesystem
   cd Tools/tolua++
   lua5.1 tolua++.lua

5. 运行编译脚本。

   • 进行首次编译

     在 ARM 架构上

     cd Projects/Linux
     make arm

     在 x86_64 架构上

     cd Projects/Linux
     make x86_64

   • 进行后续增量编译

     cd Projects/Linux
     make

6. 运行生成的软件。

   cd Assets
   ../Projects/Linux/build/dora-ssr
   
   # 或者用命令行参数指定资源目录
   ./Projects/Linux/build/dora-ssr --asset Assets

3. 构建 Web IDE

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

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

3. 初始化项目并进入 Dora Dora 编辑器开发模式。

   请选择你在进行 Web IDE 开发的平台。

macOS

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

  或者你可以直接生成完整 Dora SSR 项目的 Web IDE 发布文件。pnpm build 现在会自动完成 YarnEditor 的构建与复制，并将最终 Web IDE 构建结果同步到 Assets/www。

# `pnpm build` 还会自动把最终构建结果同步到 Assets/www
cd Tools/dora-dora
pnpm build

Linux

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

  或者你可以直接生成完整 Dora SSR 项目的 Web IDE 发布文件。pnpm build 现在会自动完成 YarnEditor 的构建与复制，并将最终 Web IDE 构建结果同步到 Assets/www。

# `pnpm build` 还会自动把最终构建结果同步到 Assets/www
cd Tools/dora-dora
pnpm build

Windows

cd Tools\dora-dora && pnpm install
pnpm build-yarn-editor
pnpm start

  或者你可以直接生成完整 Dora SSR 项目的 Web IDE 发布文件。pnpm build 现在会自动完成 YarnEditor 的构建与复制，并将最终 Web IDE 构建结果同步到 Assets/www。

# `pnpm build` 还会自动把最终构建结果同步到 Assets/www
cd Tools\dora-dora
pnpm build