最佳实践:SIMD 融合产物打包
SIMD 即单指令多数据,能用一条 CPU 指令同时批量计算多组数据,适合图像、物理这类大量重复运算。团结的测试报告显示,开启 SIMD 对帧率优化明显。
但 SIMD 在 iOS 16.4 版本才开始支持,所以为了兼容 iOS 16.4 以下的用户,需要在 iOS 16.4 以下的设备上运行非SIMD产物。因此需要生成融合包。
本文说明如何用团结引擎从同一 Unity 项目构建非 SIMD 包和 SIMD 包,并使用 TTSDK 多包融合工具生成最终融合产物。
1.操作概览
- 1.关闭 SIMD 构建默认包。
- 2.基于同一份 Unity 工程和同一提交,仅打开 SIMD 开关,构建 SIMD 条件包。
- 3.打开“多包融合工具”,配置两个输入包和输出目录。
- 4.执行严格校验,通过后开始融合。
- 5.检查融合产物目录结构。
2.构建前准备
两次构建应满足:
- •使用团结引擎。只有团结引擎有SIMD配置项。
- •TTSDK 版本最低为 6.9.5。
- •来自同一 Unity 工程。
- •
project.config.json 中的 AppID 一致。- •除 WebAssembly SIMD 开关外,TTSDK、UnityPlugin、资源和业务配置保持一致。
- •分别使用两个全新的输出目录,避免残留旧 Wasm 或 Data 文件。
示例目录:
BuildOutput/ ├── non-simd/ ├── simd/ └── merged-simd/(融合后产物)
3.构建 SIMD 包和非 SIMD 包
- 1.在 Player Settings -> Publish Settings 关闭 SIMD,按照正常打包流程出包,比如BuildOutput/non-simd/。
- 2.开启 SIMD,按照正常打包流程出包,比如BuildOutput/simd/。确保这两个目录不要互相覆盖。
现在我们的目录结构为
BuildOutput/ ├── non-simd/ ├── tt-minigame/ └── simd/ ├── tt-minigame/
4.配置多包融合工具
在 Unity 菜单中进入:
ByteGame → TTSDK Tools → 多包融合工具
字段介绍:
配置项 | 填写内容 | 说明 |
默认包路径 | BuildOutput/non-simd/tt-minigame | 非SIMD产物。当然开发者也可把SIMD产物作为默认包,只要后面条件判断正确即可。这里把非SIMD产物作为默认包。 |
条件表达式 | capabilities.wasmSimd | 默认的判断条件,生成融合产物后可以在package-selector.js中修改。 |
条件包后缀 | simd | 用于说明条件包的特征,在融合后会当做文件夹名称后缀。融合后不要再改文件名。 |
条件包路径 | BuildOutput/simd/tt-minigame | 选择 SIMD 构建产物。 |
输出目录 | BuildOutput/merged-simd/ | 不能与输入目录相同或互相包含。只要是独立的目录即可。 |
融合版插件版本 | | 默认值为该TTSDK内置的插件版本(对应game.json的plugin.version)。开发者也可以手动指定版本。 |
额外公共路径 | | 不同场景包的公共部分。 |
5.执行校验与融合
- 1.(可选)点击严格校验。
- 2.(可选)查看 Console ,修复全部红色错误;黄色警告需确认差异符合预期。
- 3.点击开始融合。
- 4.等待工具提示融合成功,并打开输出目录。
常见校验失败原因:
- •两个输入包的 AppID 不一致。
- •
wasmcode/ 或 data-package/ 中残留多份历史文件。- •输入目录和输出目录相同,或目录之间存在包含关系。
- •输入产物缺少 TTSDK 必需文件。
6.检查融合产物
标准的 SIMD 两包融合产物结构如下:
merged-simd/ ├── game.js # 根入口:根据条件选择包 ├── game.json # 根配置:聚合所有分包声明 ├── package-selector.js # 条件判断模块,融合产物独有 ├── project.config.json # 项目配置(使用默认包) ├── images/ # 公共资源(从默认包复制) ├── StreamingAssets/ # 公共 StreamingAssets ├── minigame/ # 默认包(标准包) │ ├── wasmcode/ # 原始包 wasm │ │ └── xxx.webgl.wasm.code.unityweb.wasm │ ├── data-package/ # 数据包 │ │ └── xxx.webgl.data.unityweb.bin │ └── runtime/ # 其他运行时必要文件 │ ├── game.js │ ├── webgl.framework.js │ ├── plugin.config.js │ ├── unity-namespace.js │ └── webgl-wasm-split.js └── minigame-simd/ # 条件包(SIMD 包) ├── wasmcode/ # 条件包分包名加后缀 → wasmcode-simd │ └── xxx.webgl.wasm.code.unityweb.wasm ├── data-package/ # → data-package-simd │ └── xxx.webgl.data.unityweb.bin └── runtime/ # 其他运行时必要文件 ├── game.js ├── webgl.framework.js ├── plugin.config.js ├── unity-namespace.js └── webgl-wasm-split.js
重点确认:
- •根目录存在
package-selector.js,这是融合产物的识别标志。- •
minigame/ 为非 SIMD 默认包。- •
minigame-simd/ 为 SIMD 条件包。- •两个场景目录都包含完整的
runtime/、wasmcode/、data-package/ 和 Symbols 文件。7.wasm分包
IDE 从 4.5.7 开始支持融合产物的wasm分包,分包的操作、步骤均和原来一致。
