CocosCreator 接入指南

一、构建/发布

芒果小游戏运行于 WebView，采用 Cocos Creator 系列引擎开发的游戏，发布芒果小游戏核心步骤：

1.1 构建

1. 发布平台选择 Web-Mobile
2. 点击构建完成

• Cocos Creator 2.x 引擎官方发布文档： https://docs.cocos.com/creator/2.4/manual/zh/publish/publish-web.html
• Cocos Creator 3.x 引擎官方发布文档： https://docs.cocos.com/creator/3.8/manual/zh/editor/publish/publish-web.html

1.2 补文件

在构建产物根目录，手动追加以下文件：

• project.config.json
• game.json

文件内容请参考官方文件说明。

1.3 提交/发布

使用 芒果开发者工具 直接导入该目录：

1. 调试
2. 预览
3. 一键上传，完成上线

建议：使用真机进行测验，确保游戏在真实环境下运行正常。

二、包体优化注意事项

对上传平台的包体进行了大小限制，需注意以下四点：

1. 分包

• 推荐做法：将游戏资源进行 Bundle 分包，并将这些分包部署在 CDN 服务器上，进行远程分包，不要进行本地分包。
• 目的：减少初始包体大小，加快首次加载速度，提升用户转化率。

2. 加载分包

• Cocos Creator 2.x 在代码中加载远程分包时，需手动指定 CDN 地址：

cc.assetManager.loadBundle("https://myserver.com/mybundle");

注意：不能依赖默认路径，必须显式拼接远程地址。

• Cocos Creator 3.x 远程分包，参考官方文档： https://docs.cocos.com/creator/3.8/manual/zh/editor/publish/publish-web.html

3. 真机加载失败排查建议

• 问题现象：分包在芒果开发者工具中能正常加载，但在真机上失败。
• 常见原因：CDN 未正确配置跨域（CORS）。
• 解决方案：检查并配置 CDN 的跨域设置，参考提供的《设置跨域指南》。

4. 上传包体大小与转化率关系

• 芒果开发者工具会将发布后目录中的所有内容打包上传。
• 用户首次进入游戏需经历：下载包体 → 解压 → 启动游戏
• 结论：包体越小，下载越快，转化率越高。
• 建议：尽可能压缩资源、剔除冗余文件、使用远程分包等手段最小化上传包体体积。

三、接入平台接口

在游戏中，引用芒果小游戏平台的接口，以 isLogin 为例，有以下几种方式：

window.mgtv.isLogin()  //window['mgtv'].isLogin() 、mgtv.isLogin()

• 重要接口请参考接口说明

四、调试

需要查看调试日志信息时，可以通过以下方式：

1. 在发布时勾选 VConsole 选项
2. 或在发布后的 index.html 中加入以下代码：

<script type="text/javascript" src="https://unpkg.com/vconsole@latest/dist/vconsole.min.js"></script>
<script type="text/javascript">
  new window.VConsole();
</script>

注意：正式发布版本时，需要隐藏相关调试设置。