Cocos Creator 发布入门:Web、Android 构建与上线检查

从构建面板、Web 静态部署到 Android 打包前检查,整理一份适合新手的 Cocos Creator 发布流程。

Cocos Creator 发布入门:Web、Android 构建与上线检查

把场景跑通只是开发的前半段。真正发布前,还需要确定目标平台、检查构建产物,并用真实环境验证资源、横竖屏和输入。本文整理一份适合新手的 Cocos Creator 发布流程。

1. 先确定发布目标

同一个项目可以面向 Web、Android、iOS 等平台构建,但不要一开始就同时处理全部平台。建议按这个顺序推进:

  1. 先使用浏览器预览验证玩法。
  2. 再构建 Web,部署到测试服务器。
  3. 最后准备 Android 真机包,处理签名和渠道配置。

Web Mobile 适合优先兼容移动浏览器;Web Desktop 更适合以固定游戏分辨率为主的桌面体验。项目一开始就要在设计分辨率、横竖屏和触摸操作上做好取舍。

2. 构建 Web 版本

打开菜单 Project,然后进入 Build。选择 Web Mobile 或 Web Desktop,确认发布目录后点击 Build。构建结束后先在本地点击 Run,确认页面能够加载、音效正常、输入可用。

部署时不要只复制 index.html。构建输出目录里的脚本、资源目录和配置文件必须保持原有相对路径,一并上传到服务器。

一个简单的 Nginx 静态站点配置可以参考:

text
location = /game {
  return 301 /game/;
}

location ^~ /game/ {
  alias /www/wwwroot/game/;
  index index.html;
  try_files $uri $uri/ =404;
}

这里的重点是 alias 目录结尾带斜杠,并且 URL 前缀与目录结构保持一致。上传完成后直接访问 /game/,再打开浏览器开发者工具检查 Network 里是否存在 404。

3. 静态资源缓存怎么处理

游戏的 index.html 通常应该使用短缓存或不缓存,因为它负责引用最新版本的资源。带有版本号或哈希的静态资源可使用较长缓存。每次发版后,都要用无痕窗口或清空缓存再测一次,避免把旧缓存误认为新版本问题。

4. Android 构建前检查

在 Build 面板中选择 Android 平台后,先确认:

  • 包名是否唯一且符合你的发行计划。
  • 版本号和 version code 是否已递增。
  • 图标、启动图、横竖屏方向是否正确。
  • 触摸、返回键、音频和后台恢复是否在真机上验证。
  • 所需的 Android SDK、JDK、Gradle 环境是否与当前 Creator 版本兼容。

第一次不要急着做正式签名包。先构建 debug 包,安装到至少一台 Android 真机上测试启动、网络、资源加载和性能。等流程稳定后再补充正式签名与渠道配置。

5. 发布前检查清单

  1. 设计分辨率和横竖屏是否符合预期。
  2. PC 鼠标、移动端触摸和返回行为是否可用。
  3. 首屏加载、资源失败、弱网和断网时是否有可理解的反馈。
  4. Web 域名是否启用了 HTTPS,资源地址是否不存在混合内容。
  5. 页面刷新后是否仍能正常进入游戏。
  6. 浏览器控制台和服务器日志中是否有资源 404 或跨域错误。

6. 发布不是终点

第一版上线后,建议记录设备型号、错误日志、首屏加载时间和玩家操作路径。下一轮再按真实问题处理资源分包、版本检查、对象池、远程配置和数据统计。小步发布、快速验证,比一次堆满所有功能更适合独立开发者。

参考