如何构建 Dora SSR 引擎

1. 获取项目源码

GitHub

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

AtomGit

git clone https://atomgit.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/3rdParty/YarnEditor && yarn && yarn build
rm -rf ../../public/yarn-editor
mv dist ../../public/yarn-editor
cd ../.. && yarn
yarn start

  或者你可以将 Web IDE 发布文件进行生成后，复制到项目的 Assets/www 下面，然后再启动 Dora SSR 引擎，进行完整项目功能的测试使用。

# 确保之前步骤里的 YarnEditor 的编译和文件复制已完成
cd Tools/dora-dora
yarn build
rm -rf ../../Assets/www
mv build ../../Assets/www

Linux

cd Tools/dora-dora/3rdParty/YarnEditor && yarn && yarn build-linux
rm -rf ../../public/yarn-editor
mv dist ../../public/yarn-editor
cd ../.. && yarn
yarn start

  或者你可以将 Web IDE 发布文件进行生成后，复制到项目的 Assets/www 下面，然后再启动 Dora SSR 引擎，进行完整项目功能的测试使用。

# 确保之前步骤里的 YarnEditor 的编译和文件复制已完成
cd Tools/dora-dora
yarn build
rm -rf ../../Assets/www
mv build ../../Assets/www

Windows

cd Tools\dora-dora\3rdParty\YarnEditor && yarn && yarn build-win
rmdir /Q /S ..\..\public\yarn-editor
move dist ..\..\public\yarn-editor
cd ..\.. && yarn install --network-timeout 1000000
yarn start

  或者你可以将 Web IDE 发布文件进行生成后，复制到项目的 Assets/www 下面，然后再启动 Dora SSR 引擎，进行完整项目功能的测试使用。

# 确保之前步骤里的 YarnEditor 的编译和文件复制已完成
cd Tools\dora-dora
yarn build
rmdir /Q /S ..\..\Assets\www
move build ..\..\Assets\www