从工程到真机：微信小游戏构建链

在编辑器里按 Play，只验证了编辑器环境中的一部分行为。微信小游戏还要经过代码与资源构建、平台转换、开发者工具和真实设备。

第一步：准备最小验证工程

不要先导出包含全部插件和美术的正式项目。先保留一个场景、一张 Sprite 或 UI 图片、一个按钮、一段文本和少量日志。

记录编辑器、SDK、包版本和平台模块。确认工程路径、磁盘空间与 Git 状态，保留原始工程。转换产物应与源工程分开，避免清理输出目录时误删源资源。

第二步：安装与核对 SDK

官方仓库给出的安装方式是通过 Package Manager 的 “Add package from git URL” 添加：

https://github.com/wechat-miniprogram/minigame-tuanjie-transform-sdk.git

这是官方安装入口，不是固定版本承诺。正式工程应按经过验证的版本或提交锁定依赖；不要长期让任意最新分支更新决定构建结果。团结平台可能已集成 SDK，避免重复安装互相冲突的版本。

第三步：构建与转换

具体菜单随产品和版本不同。通用 Unity 路径与团结专用平台入口要分别看对应官方说明。不要照着另一版本截图盲目调整所有参数。

构建错误时保留第一条根因、完整相关堆栈和版本记录。原生插件、AOT、代码裁剪、字体、Shader 和资源路径都可能造成编辑器与产物不一致。

第四步：开发者工具检查

确认导入的是生成的小游戏工程，AppID、合法域名、资源地址和调试配置符合当前项目。调试时临时放宽检查，不代表正式环境已经配置正确。

如果空工程导出后 Runtime 能力缺失，官方 SDK README 提到了运行时包可能被裁剪的情况。应核对当前版本的建议做法和真实依赖，而不是随意关闭全部裁剪。

第五步：真机验证

测试	要观察什么
首次启动与缓存启动	下载、首屏、可操作时间
触摸与屏幕适配	多点、边缘、长宽比、安全区
音频与广告往返	中断、恢复、用户静音设置
网络与资源失败	错误提示、重试、取消、旧回调
连续合成与长时间运行	帧时间、内存、发热与状态正确性

Android 通过不能替代 iOS。微信版本、系统版本与图形路径会改变行为；构建模式也要记录。

包体和图形能力不要背旧数字

包体、分包、高性能模式和图形路径都可能变化。当前 SDK 已有多线程和 WebGL2 等更新记录；iOS Metal 文档仍包含 Preview 条件。选择时按版本和设备核对，并保留合适回退。

参考：SDK README、团结转换说明、SDK 更新记录。核验日期：2026-10-31。