Cocos Creator 发布入门:Web、Android 构建与上线检查
把场景跑通只是开发的前半段。真正发布前,还需要确定目标平台、检查构建产物,并用真实环境验证资源、横竖屏和输入。本文整理一份适合新手的 Cocos Creator 发布流程。
1. 先确定发布目标
同一个项目可以面向 Web、Android、iOS 等平台构建,但不要一开始就同时处理全部平台。建议按这个顺序推进:
- 先使用浏览器预览验证玩法。
- 再构建 Web,部署到测试服务器。
- 最后准备 Android 真机包,处理签名和渠道配置。
Web Mobile 适合优先兼容移动浏览器;Web Desktop 更适合以固定游戏分辨率为主的桌面体验。项目一开始就要在设计分辨率、横竖屏和触摸操作上做好取舍。
2. 构建 Web 版本
打开菜单 Project,然后进入 Build。选择 Web Mobile 或 Web Desktop,确认发布目录后点击 Build。构建结束后先在本地点击 Run,确认页面能够加载、音效正常、输入可用。
部署时不要只复制 index.html。构建输出目录里的脚本、资源目录和配置文件必须保持原有相对路径,一并上传到服务器。
一个简单的 Nginx 静态站点配置可以参考:
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. 发布前检查清单
- 设计分辨率和横竖屏是否符合预期。
- PC 鼠标、移动端触摸和返回行为是否可用。
- 首屏加载、资源失败、弱网和断网时是否有可理解的反馈。
- Web 域名是否启用了 HTTPS,资源地址是否不存在混合内容。
- 页面刷新后是否仍能正常进入游戏。
- 浏览器控制台和服务器日志中是否有资源 404 或跨域错误。
6. 发布不是终点
第一版上线后,建议记录设备型号、错误日志、首屏加载时间和玩家操作路径。下一轮再按真实问题处理资源分包、版本检查、对象池、远程配置和数据统计。小步发布、快速验证,比一次堆满所有功能更适合独立开发者。
参考
- Cocos Creator Web 发布:https://docs.cocos.com/creator/3.8/manual/en/editor/publish/publish-web.html
- Cocos Creator 构建发布:https://docs.cocos.com/creator/3.8/manual/en/editor/publish/