调试与排查

本章介绍如何对转换后的 Unity 小游戏进行真机调试、查看日志与排查常见问题。命令行工具的安装与配置见环境准备，通用真机调试流程见调试指南。

一、真机调试

在 mgc.config.js 所在目录执行以下命令，构建 Debug 测试包并生成二维码：

$ mgc debug

使用美团测试 App 扫码后，会从线上拉取 Debug 包并运行：

• Android：点击屏幕右上角胶囊按钮的 **「...」**唤起面板，进入开发者面板查看游戏日志。
• iOS：点击屏幕中的 debug 按钮查看日志。

目前 Unity 小游戏的真机调试需使用专用的美团测试 App，请联系对接人员 / 运营同学获取。

二、查看日志与错误堆栈

• 在开发者面板的日志中可查看 Debug.Log 输出与运行期报错。
• WebGL 下的报错堆栈通常是经过裁剪 / 混淆的地址信息，需结合导出时生成的符号信息还原为可读的函数调用栈，再定位到具体代码。
• 建议尽量多机型、多场景地扫码测试，覆盖主流品牌与中低端机型。

三、常见问题排查

1. 优先排查游戏内逻辑：先在默认渲染模式、默认配置下确认问题是否复现，规避游戏自身的业务问题。
2. 黑屏 / 渲染异常：先确认是否为游戏渲染逻辑问题；若仅在 EmscriptenGLX 模式下出现，按该章「常见问题」排查。
3. 资源 / 网络加载失败：检查资源 CDN 是否部署完整、安全域名与跨域是否配置正确，详见网络通信适配。
4. 启动慢 / 卡顿：参考启动性能优化与运行性能优化。
5. API 调用报错：对照开放文档与常见问题 FAQ中的参数说明与报错提示排查。

四、联系我们

无法自行解决的问题，可到对接群交流咨询。咨询时请尽量提供以下信息，便于复现与排查：

• 问题描述：使用什么参数调用什么能力、出现什么报错与现象，附关键代码片段或截图。
• 复现方式：游戏二维码及问题的复现路径；逻辑复杂时建议提供可复现的最小测试包。
• 环境信息：引擎版本、转换插件版本、机型与系统版本、是否开启 EmscriptenGLX 等。