Unity 转微信小游戏：从 WebGL 导出到真机预览的完整路径

Unity 转微信小游戏：从 WebGL 导出到真机预览的完整路径

【免费下载链接】minigame-unity-webgl-transform微信小游戏Unity引擎适配器文档。项目地址: https://gitcode.com/GitHub_Trending/mi/minigame-unity-webgl-transform

Unity WebGL 微信小游戏适配是一套基于 WebAssembly 的方案：它把现有 Unity 工程直接导出成微信小游戏，不要求你换引擎，也不要求把游戏逻辑翻译成 JavaScript。你只需要在工程里装上转换插件、填好几个参数，就能拿到一个可以直接被微信开发者工具打开的小游戏项目。会用 Unity 打 WebGL 包的话，这条路可以一次走通。

能力边界速览：哪些事它替你干了

• 工程里已有大量 C# 逻辑和第三方插件→ 大部分插件原样保留，玩法层不用重写，Unity 2018 及以上（含团结引擎）的兼容由转换工具兜底，你只需关注游戏本身。
• 想用登录、分享、好友关系链这类微信能力→ 平台能力以 C# SDK 提供，调用方式和普通 Unity API 一样，不用自己写 JS 桥接层。
• 资产体积装不进小游戏的包→ 首包资源走 CDN 下载，其余走 AssetBundle / Addressable 按需加载，包体大小不再卡死你的内容量。
• 重度游戏要做性能优化→ 微信压缩纹理、WASM 分包、性能监控面板这类工具可以直接用，不用自己从零搭。

边界也要说清楚：小游戏代码包 20MB 的上限它绕不过去，装不进包又挪不上 CDN 的资源，仍然要你自己想办法瘦身。

从 Unity 工程到真机预览：五步跑通

整条链路是"兼容性评估 → 项目转换 → 微信平台能力接入 → 体验调优 → 发布上线与监控"五阶段，最短路径只用到前几个阶段里和转换直接相关的部分。

第 1 步：装适配插件进工程

• 做什么：把微信 SDK 装进 Unity 工程。
• 怎么做：Unity 2019 及以上版本，顶部菜单Window→Package Manager→ 右上角+→Add package from git URL，填入官方提供的 SDK 仓库 git 地址即可；Unity 2018 不支持这种方式，直接从官网下载资源包导入工程。
• 确认没做错：Unity 顶部菜单栏多出"微信小游戏"一级菜单，工程下出现Assets/WX-WASM-SDK-V2目录。

第 2 步：Build Settings 只勾 Loading 场景，模板选 WXTemplate

• 做什么：控制进包的场景范围，并换用微信的导出模板。
• 怎么做：File→Build Settings，Scenes In Build里只勾 Loading 场景，Platform 选 WebGL；再到Project Settings→Player→Resolution and Presentation，把WebGL Template从 Default 切成WXTemplate。
• 确认没做错：场景列表里只剩一个 Loading；模板显示为微信图标。玩法场景不要进包，它们后面按需加载。

第 3 步：转换面板填三个必填项，点"生成并转换"

• 做什么：执行 WebGL 构建 + 小游戏转换。
• 怎么做：顶部菜单微信小游戏→转换小游戏，在面板里填必填项，点右下角生成并转换，等转换完成。

常用可选项：游戏方向（横竖屏）、首包资源加载方式（CDN 下载或小游戏包内加载）、预下载文件列表（用;分隔）。

• 确认没做错：导出路径下生成两个目录：

. ├── minigame └── webgl

minigame是待会儿导入开发者工具的项目，webgl是要部署到 CDN 的资源目录，两个一个都不能少。

第 4 步：MP 后台开快捷配，开发者工具导入 minigame 目录

• 做什么：解决首次运行"插件未授权"的报错，把项目装进 Stable 版微信开发者工具。
• 怎么做：开发者工具里导入转换产物中的minigame目录。第一次打开会报插件未授权，这是正常现象——登录 MP 微信公众平台，走能力地图→生产提效包→快适配点开通，再回到工具重新打开项目。
• 确认没做错：模拟器里能跑到 Loading 页，工具顶部的模拟器、编辑器、调试器三个页签都可用。注意安装稳定版 Stable Build，不要用小游戏版 Minigame Build。

第 5 步：扫预览码上真机

• 做什么：在真机上确认真实体验。
• 怎么做：开发者工具顶部工具栏点预览，手机微信扫码启动游戏。
• 确认没做错：手机上正常进入 Loading，资源从 CDN 拉取成功。✅ 走到这里，"Unity 项目 → 微信开发者工具预览"这条最短路径就闭环了。

拿真项目压一遍：你的游戏能不能上

• 3D 回合制（我叫MT2）：3D 资产多、场景多，适配时重点是压住 Loading 场景的体量、把资源拆成按需加载；这两点做好，3D 画面还原交给转换工具即可。
• 休闲（旅行串串、小小蚁国）：包体小、首屏短，首包资源加载方式可以直接选"小游戏包内"，体验接近普通小程序；关键是大图大资产别塞进首包。
• 重度 MMO（热血神剑、九梦仙域）：在线人多，内存和帧率是主要瓶颈，性能优化工具（压缩纹理、内存面板、WASM 分包）要提前跑通；想调高内存上限的，maxStorage需要单独申请。

你的项目介于这几种之间时，用"资源体积 + 启动时长"对照最接近的一档来估工作量。

接进自己的流水线：CI 里怎么调转换工具

转换面板做的事，等价于读一份配置加执行一次导出，所以自动化只做两件事：

1. 改配置：把 appid、CDN、导出路径、Orientation、assetLoadType、preloadFiles等直接写进Assets/WX-WASM-SDK/Editor/MiniGameConfig.asset，让配置随仓库走。
2. 调导出：在 CI 里执行的编辑器脚本中直接调WXEditorWindow的DoExport方法：

var win = new WXEditorWindow(); win.DoExport();

一个容易漏的细节：Package 方式安装时 SDK 主体不在 Assets 下，但Assets/WX-WASM-SDK-V2数据目录会自动生成——CI 环境里要保证这个目录和MiniGameConfig.asset随工程提交，否则导出的小游戏会缺配置。

坑与判断：第一轮大概率会碰上的 5 个场景

1. 开发者工具报"插件未授权"→ 去 MP 后台能力地图 - 生产提效包 - 快适配开通，别动代码、别重导。
2. 真机上白屏或行为异常→ 先查是不是点了"真机调试"。预览只能扫码运行，真机调试功能不能用，用了会影响游戏正常运行。⚠️
3. 导出后开发者工具报微信 Runtime 包缺失（空工程、或代码里从不调用 WXSDK 的工程高发）→ 引擎把 Runtime 包裁剪掉了，在工程合理位置加一次真实调用即可，比如WX.GetSystemInfo(new GetSystemInfoOption())。
4. 小游戏包超出 20MB 传不上去→ 首包资源切 CDN 加载，非首帧资源全部走 AssetBundle / Addressable 按需加载。
5. 改了maxStorage内存上限却不生效→ 这项要联系研发助手开通权限才生效，建议先用性能工具量出真实内存水位再申请。

跑通这五步，你手里就有一条可重复执行的"Unity → 微信小游戏"转换链路，放进 CI 之后每次发版只剩上传资源这一步。建议下一步把webgl目录的 CDN 上传和版本化发布也接进流水线——预览跑通之后，这是离正式发布最近的一块工作。

【免费下载链接】minigame-unity-webgl-transform微信小游戏Unity引擎适配器文档。项目地址: https://gitcode.com/GitHub_Trending/mi/minigame-unity-webgl-transform