Back to Cocos Engine

Spine WASM 编译指南

native/cocos/editor-support/spine-wasm/README-zh.md

3.8.81.5 KB
Original Source

Spine WASM 编译指南


1. 环境要求

  • EMSdk 3.1.41:
    需下载 EMSdk,并根据官方仓库文档配置环境变量。
  • CMake:
    需将 CMake 添加到系统 PATH 环境变量。
  • Ninja:
    需将 Ninja 添加到系统 PATH 环境变量。

2. 修改 CMakeLists.txt

  • 设置 Spine 版本:
    根据需要的 Spine 版本修改 SPINE_VERSION 配置。
  • 调试/发布模式:
    根据调试需求修改 CMAKE_BUILD_TYPE
  • WASM/ASM.js 编译:
    设置 BUILD_WASM=1 编译 WASM,或 BUILD_WASM=0 编译 ASM.js。

命令示例:

bash
emcmake cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DBUILD_WASM=1

3. 创建构建目录

  • 在当前目录下创建临时目录(如 temp):
bash
mkdir temp && cd temp

4. 编译步骤

  1. 激活 EMSdk 环境

    • Windows:

      bash
      emsdk_env.bat
      
    • Linux/macOS:

      bash
      source ./emsdk_env.sh
      
  2. 生成构建文件

bash
emcmake cmake ..
  1. 使用 Ninja 编译
bash
ninja

5. 编译后处理

  • 生成文件

    • spine.wasm
    • spine.js
  • 文件重命名与移动

    • spine.js 重命名为 spine.wasm.js
    • 将文件复制到 native/external/emscripten/spine 目录下。

注意事项

  1. 版本兼容性:
    确保 EMSdk、CMake 和 Spine 版本兼容。
  2. 路径有效性:
    检查所有路径(如 emsdk_env、输出目录)是否有效。