企业官网建设流程全解析

• 游戏开发
• 移动开发
• WebAssembly

本文基于 Design/iOSOptimization.md 撰写，系统讲解微信小游戏在 iOS 环境下的「高性能模式」与「高性能+模式」：为什么要开、性能提升多少、如何开通、有哪些硬性限制，以及上线前必须完成的优化组合拳。读者看完即可对照自己的 Unity WebGL 小游戏项目完成 iOS 高性能模式的评估、开通、压测与避坑排障。

在 iOS 环境下，微信小游戏标准的 WASM 运行模式是无 JIT（即时编译）的，对计算性能要求较高的游戏会受到明显限制：中低端机帧率偏低、流畅度难以达到上线标准，或者 CPU 计算资源消耗过高、运行一段时间后设备温度持续上升。小游戏环境框架为此提供了高性能运行模式，在 CPU 算力上带来明显提升，但同时也引入了更严格的内存与代码包体限制，需要开发者采取合适的手段把效果做到最优。本文将以仓库内 iOS 优化文档为主体，结合 内存优化、代码分包、压缩纹理 等配套文档，给出从开通到优化的完整路径。

一、背景：iOS 上标准 WASM 模式的性能瓶颈

在 iOS 普通模式（无 JIT）下，Unity WebGL 小游戏通常面临两个典型问题：

1. 中低端机帧率较低，流畅度难以达到上线标准；
2. CPU 计算资源消耗过高，运行一段时间后设备温度持续上升，长时间运行容易越来越烫。

这两个问题本质上是同一件事的两面：标准模式下 WASM 只能解释执行，算力受限，游戏为了跑满逻辑只能持续占满 CPU。高性能模式正是针对这一场景提供的运行能力增强方案。

二、两种高性能运行模式

2.1 高性能模式

高性能模式在小游戏独立进程内启用 JIT 执行 WASM 代码，CPU 算力得到明显提升，适用于「遇到 iOS 环境运行性能不足、运行发烫」的小游戏。该模式也意味着更严格的内存与代码包体限制（详见本文第五章），需要配合内存与代码体积优化才能稳定上线。

2.2 高性能+模式

高性能+模式在高性能模式基础上进一步演进：在保留游戏独立进程的同时，将渲染重新挪回微信进程，从而改善渲染效果与渲染内存消耗。特别地，以下两类游戏建议开启高性能+模式：

• 使用 WebGL2 的游戏（WebGL2 渲染支持说明可参考仓库内 Design/WebGL2.md）；
• 内存压力大的游戏。

开启后务必验证进程内存、渲染兼容性、帧耗时数据是否正常。高性能+模式也能显著降低 GPU 内存，是 GPU 显存压力较大游戏的重要解法（详见 Design/OptimizationMemory.md 中的 QA 部分）。

三、性能提升实测

3.1 CPU 消耗对比

通过多款游戏项目实测，iOS 不同执行模式下的 CPU 随时间消耗如下图所示（横轴为时间，纵轴为 CPU 占用比例）：

图中对比了「普通模式」「高性能+未分包」「高性能+分包」三种场景，可以得出三个结论：

• 高性能模式在长期执行过程中 CPU 明显低于普通模式，后者长期处于高 CPU 占用，因此长时间运行容易越来越烫；
• 游戏启动初始阶段，高性能模式存在 CPU 高峰，用于 WebAssembly 编译优化（图中标注的编译优化时间与代码体积相关，低档机约为 1 分钟量级）；
• 采用代码分包后，高性能模式能较快回落 CPU 占用并维持正常水平，这直接回答了后文 QA 中"为什么开启了高性能模式，游戏启动很烫"的问题。

3.2 Benchmark 压力测试

使用 Unity 所提供的 Benchmark Demo 的部分案例进行评测（仓库内对应示例工程位于 Demo/Benchmark）：

• Instantiate & Destroy
• Animation & Skinning
• Physics Cubes
• AI Agents

测试过程为不断增加运算复杂度，直到帧率下降到特定数值。分数越高，代表运行能力越强。下图分别为 iOS 端普通模式与高性能模式的得分：

可以看到，在几个压测示例中高性能模式均明显优于普通模式（如普通模式 Overall Score 约 6728，高性能模式约 51174）。不过文档同样提醒：经实际游戏测试，游戏帧率都会得到明显改善，但无法达到 Benchmark 中几乎一个数量级的差异——Benchmark 是纯计算密集型理想场景，实际游戏受渲染、加载等综合因素影响，改善幅度需要以真机实测为准。

四、如何开通

iOS 端小游戏高性能模式适用于遇到 iOS 环境运行性能不足、运行发烫的小游戏。开通步骤如下：

1. 登录微信公众平台，进入能力地图 → 研发能力 → 生产提效包，点击开通高性能模式。入口在「能力地图-研发能力」板块的「生产提效包」功能卡片中：

2. 开通成功后，通过配置小游戏项目根目录game.json的iOSHighPerformance字段为true即可进入高性能模式：

{ "iOSHighPerformance": true }

3. 通过去掉该开关可以正常回退到普通模式，方便开发者在两种模式之间切换对比。

五、高性能模式的两大硬性限制

高性能模式并非免费午餐，它通过更苛刻的内存与代码体积约束换取算力。开发者务必明确这两条红线。

5.1 内存限制

开发者务必保证内存峰值不超过该数值，建议根据优化 Unity WebGL 的内存的指引系统性地优化内存。

理解这个限制，需要先了解小游戏进程内的内存构成。以 iOS 高性能模式为例，一款代码体积 30MB 的游戏（对应webgl/Build/xxx.code.unityweb或code.wasm），其内存占用大致为：

小游戏基础库（约 100~150MB） + Canvas（约 70MB，与设备物理分辨率相关） +编译内存（约 300MB）+ UnityHeap + Gfx 显存 + 音频 + JavaScript 内存（通常 <100MB）

其中几个关键点（详见 Design/OptimizationMemory.md）：

• WASM 编译内存：Unity WebGL 把所有代码编译为跨平台 WebAssembly 二进制，运行时需编译执行，占用极大——iOS 上 30MB 未压缩代码约需 300MB 运行时编译内存，这部分是内存大头；
• UnityHeap：由托管堆（C# 托管对象）、本机堆（Unity Native 对象）与原生插件内存（如 Lua 的 malloc）组成，典型占用的动态内存上限需要开发者在转换面板合理预留；
• 文件系统陷阱：Emscripten 用文件系统模拟 Linux/POSIX 接口，代价是占用与文件同等大小的内存，因此请勿使用首资源包、Addressable Cache 机制、WWW.LoadFromCacheOrDownload等 Cache API。

5.2 代码体积限制

高性能模式下，WASM 代码将被编译并优化，需要占用更多的编译消耗与内存。如果未做优化，可以明显感受到启动开始阶段（如启动前 1 分钟内）设备发烫。

上线发布时，特别建议使用 WASM 代码分包 + 压缩纹理 + UnityHeap 预留这几种优化手段。

六、上线前的优化组合拳

针对上述两大限制，文档明确给出三条主线优化手段，并配合仓库内对应文档形成完整闭环：

6.1 WASM 代码分包：降编译内存与启动发热

代码分包 采用 Profile Guided Optimization 方式，按函数粒度对 WASM 代码包进行拆分：将原始 wasm 拆为启动加载的主包与可延迟加载的子包。对于 iOS 高性能模式，子包不会全量加载，而是转为按函数粒度按需加载，其核心价值在于：

• 减少内存使用，支持更多 iOS 低端机运行高性能模式（一般可将原编译代码内存降低 50% 以上）；
• 减少编译时间，降低游戏前期的发烫情况。

收集与上线的经验参考值（详见 WasmSplit 文档）：首包函数个数至少要有原始包函数总数的30%以上；上线后要持续关注「新增收集函数个数」，如果线上新增较多（超过 50 个），建议重新生成分包并提审发布。

6.2 压缩纹理：降 GPU 显存与 Bundle 体积

压缩纹理工具 将纹理资源从 Bundle 中分离单独托管，并按实际运行设备 GPU 生成 ASTC、DXT、ETC2 等多种格式按需加载：

• 降低 bundle 体积，资源按需加载，加快游戏运行进度；
• 有效降低内存，GPU 硬件解码、渲染效率更高。

如果引擎版本高于 2021，可使用引擎自身的 ASTC 压缩格式；低版本引擎（2018~2020）建议使用微信 Unity SDK 压缩纹理工具。

6.3 UnityHeap 预留：防止扩容尖刺

UnityHeap 是存储所有状态、托管对象和本机对象的区域，单帧内无法 GC、Heap 只增不减且存在内存碎片，单帧内瞬间的内存峰值非常容易造成 crash。因此应在转换面板设置合理的"UnityHeap 预留内存"，通过性能面板观察DynamicMemory峰值后，设置略大于峰值（可多预留 50~100MB）。参考建议值：超休闲游戏 256、中度游戏（模拟经营、卡牌成长）496、重度游戏（SLG、MMO）768。同时注意 UnityHeap 不宜过大——>=1024MB 时大部分设备将启动失败；>=500MB 时 32 位微信（约 5% 用户）与 iOS 普通模式大概率启动失败。

七、常见问题 QA

7.1 如何判别游戏是否已经开启了高性能模式？

• 删除本地小游戏（包括开发版、体验版和正式版）；
• 重新进入小游戏并打开调试，查看 vconsole 日志，关注game start日志中的render字段，为"h5"则为高性能模式；
• 系统和基础库要求：iOS >= 14.0，基础库 >= 2.23.1，用户占比约为 90%。不满足此要求时自动回退为普通执行方式。

7.2 使用高性能模式下，游戏本身是否需要做修改？

• 业务代码无需做任何调整，普通模式与高性能模式可以无缝切换；
• 高性能模式下，请不要在服务端设置 Cookie，游戏端内会因为跨域问题读取不到 Cookie；
• Android 下载资源无问题，而高性能模式提示资源下载失败等网络问题，请参考网络通信适配中关于跨域的问题说明。

7.3 iOS 报错提示未开启 gzip/br 压缩

可通过微信开发者工具查看Content-Encoding是否为gzip或br（工具 Network 面板）：

• 如果有正确压缩，可忽略这个错误；
• 问题原因：由于跨域获取不到Content-Encoding头；
• 解决办法：增加跨域响应头：

"Access-Control-Expose-Headers": "Content-Length, Content-Encoding"

7.4 资源下载提示isTrusted

多半由于跨域问题导致。可通过开发者工具查看对应资源的 Response Header 是否有跨域头，具体排查方法参考网络通信适配关于跨域的问题。

7.5 卡在启动封面无法启动

• 右上角打开调试，重启小游戏，点三次下方的 Unity logo 打开 vconsole；
• 如果出现资源访问失败，但 Android 和开发者工具却可以下载，则参考 7.3 关于跨域问题的解法；
• iOS 15.4 系统出现"Not implemented"、"Class::FromIl2CppType"：此为 Unity 与 iOS 15.4 的 BUG，推荐使用微信提供的wasm 代码分包方案处理；
• iOS 16.7/17.0 系统出现"glGetString (GL_EXTENSIONS) - failure"：苹果官方已在 17.1 修复。对于未更新系统的玩家，也可使用高性能+模式处理。

7.6 个别游戏 UI 会出现闪烁问题

• 目前已发现iOS 15.4出现若干渲染 BUG，如stencil 特性支持问题，请查阅优化 Unity WebGL 的渲染性能（该文档明确提醒：iOS 15.4 系统使用 Stencil 可能导致渲染异常，不需要时建议在 Shader 中注释掉 Stencil 相关代码）；
• 如按上述文档去除依然无法解决，请提供可复现的 Unity 工程联系小游戏客服助手。

7.7 为什么开启了高性能模式，游戏启动很烫？

参考本文第三章的 CPU 消耗分析：如果未使用代码分包，JIT 编译优化将耗费大量性能，启动阶段（如前 1 分钟）CPU 高峰显著。使用代码分包后高性能模式能较快回落 CPU 占用并维持正常水平。

7.8 使用高性能模式下，不优化内存、WASM 代码包体积就发布上线可以吗？

不建议。iOS 高性能模式虽然能提升运行算力，但对内存、WASM 包体积有更苛刻的要求，需要投入更多精力做优化。如果不做任何优化，很有可能会遇到超出内存限制而崩溃、启动时发烫严重等问题。

上线发布时，特别建议使用 WASM 代码分包 + 压缩纹理 + UnityHeap 预留这几种优化手段。

7.9 iOS 高性能模式与安卓性能对比如何？

两种系统环境下 WASM 执行都是 JIT 代码。但由于底层虚拟机差异过大以及自身不断迭代，难以横向对比，建议以各自真机实测数据为准。

八、总结

• iOS 高性能模式为 Unity WebGL 小游戏提供 JIT 算力，能显著降低长期 CPU 占用、缓解发烫，Benchmark 压测显示性能数倍于普通模式；高性能+模式进一步将渲染挪回微信进程，改善渲染效果与渲染内存，适合 WebGL2 与内存压力大的游戏。
• 开通路径为「微信公众平台 → 能力地图 → 研发能力 → 生产提效包」，随后在 game.json 配置"iOSHighPerformance": true即可生效，去掉开关可回退对比。
• 高性能模式的代价是更严格的内存（低端机 1G、中高端机 1.5G）与代码体积限制，上线前务必完成WASM 代码分包 + 压缩纹理 + UnityHeap 预留三件套优化。
• 遇到 gzip/br 报错、isTrusted、卡启动封面、UI 闪烁等问题时，可对照本文第七章的 QA 逐项排查，网络类问题统一收敛到跨域配置，渲染类问题收敛到渲染管线与 Stencil 使用。

深入阅读：Design/iOSOptimization.md、Design/OptimizationMemory.md、Design/WasmSplit.md、Design/CompressedTexture.md、Design/UsingNetworking.md、Design/RenderOptimization.md。

• 游戏开发
• 移动开发
• WebAssembly