跳到主要内容

如何进行引擎的开发配置

1. 获取项目源码​

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

2. 进行游戏引擎运行时的开发配置​

2.1 Windows​

  1. 安装 Rust 语言环境。

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

    Tools\build-scripts\build_lib_windows.bat

  3. 安装 Visual Studio Community 2022。

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

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

2.2 macOS​

  1. 安装 Rust 语言环境。

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

    Tools/build-scripts/build_lib_macos.sh

  3. 安装最新版 Xcode。

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

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

2.3 iOS​

  1. 安装 Rust 语言环境。

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

    Tools/build-scripts/build_lib_ios.sh

  3. 安装最新版 Xcode。

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

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

2.4 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. 进行编译. 调试和运行。

2.5 Linux​

Ubuntu, Debian​

  1. 安装 Rust 语言环境。

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

    在 x86_64 架构上
    Tools/build-scripts/build_lib_linux_x86_64.sh
    在 ARM64 架构上
    Tools/build-scripts/build_lib_linux_aarch64.sh

  3. 手动生成 Lua 绑定。

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

  4. 安装依赖包。

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

  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

Arch Linux​

  1. 安装 Rust 语言环境。

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

    在 x86_64 架构上
    Tools/build-scripts/build_lib_linux_x86_64.sh
    在 ARM64 架构上
    Tools/build-scripts/build_lib_linux_aarch64.sh

  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 编辑器开发模式。 
    # macOS
    cd Tools/dora-dora/3rdParty/YarnEditor && yarn && yarn build
    rm -rf ../../public/yarn-editor
    mv dist ../../public/yarn-editor
    cd ../.. && yarn
    yarn start
    # 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
    # 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 引擎，进行完整项目功能的测试使用。 
    # macOS, Linux
    # 确保之前步骤里的 YarnEditor 的编译和文件复制已完成
    cd Tools/dora-dora
    yarn build
    rm -rf ../../Assets/www
    mv build ../../Assets/www
    # Windows
    # 确保之前步骤里的 YarnEditor 的编译和文件复制已完成
    cd Tools\dora-dora
    yarn build
    rmdir /Q /S ..\..\Assets\www
    move build ..\..\Assets\www