游戏引擎 / 系统课时
小游戏构建和 Web 构建差在哪
小游戏构建和 Web 构建差在哪
Cocos Creator 3.8 的同一个场景可以分别构建为 Web 和小游戏,但产物不能互换运行。本课以 Web Mobile 和微信小游戏为例,对齐启动入口、运行容器、资源路径及平台 API,并用一个脚本验证边界。
学习目标
- 说清 Web 页面启动与小游戏平台启动的根本区别。
- 识别资源加载、缓存、分包及平台能力的适配边界。
- 从同一场景构建并验证两个目标平台。
启动入口和运行容器不是同一套
Web 构建交给浏览器:Web 服务器提供 index.html 等文件,页面初始化画布和游戏脚本,浏览器负责网络、页面生命周期与 Web API。小游戏构建交给平台宿主:以微信小游戏为例,平台加载其项目入口 game.js,读取 game.json 等配置,由小游戏运行环境提供渲染、网络和生命周期接口。
Cocos 为小游戏提供适配层,让多数节点、组件和场景逻辑可复用;但小游戏不等于“没有地址栏的浏览器”。不能假设存在完整 DOM,也不能直接依赖任意浏览器插件。

| 比较点 | Web Mobile | 微信小游戏 |
|---|---|---|
| 启动入口 | 浏览器访问网页及 index.html |
平台加载 game.js、平台配置 |
| 运行环境 | 浏览器 DOM、Canvas、网络 API | 平台沙箱和 Cocos 适配能力 |
| 资源来源 | 站点文件或远程服务器 | 本地包、小游戏分包、远程 Asset Bundle |
| 平台服务 | 浏览器接口或另接 Web SDK | 对应小游戏平台 SDK |
| 排查工具 | 浏览器开发者工具与网络面板 | 微信开发者工具及真机调试 |
表中的“微信小游戏”是具体示例;抖音、OPPO 等平台的入口文件、限制和 SDK 并不完全相同,不能把微信规则直接复制到所有小游戏。
从同一场景各构建一次
在 Cocos Creator 的“项目 → 构建发布”新建两项任务,使用相同的启动场景和游戏内容,分别选择 Web Mobile 与 WeChat Mini Game(界面显示名称可能随语言和版本略有差异)。
- 构建 Web Mobile,使用编辑器预览或 HTTP 服务器访问完整 Web 产物,不要仅双击本地 HTML 文件。
- 构建微信小游戏,填写当前项目需要的小游戏 AppID,在微信开发者工具中打开对应构建目录并运行。
- 对比两个产物中的入口文件及资源目录,再在各自运行环境观察首屏和控制台。Web 包不应直接拿给小游戏平台作为发布包。
这是两种目标平台的独立构建,而非给 Web 文件改一个扩展名。小游戏端的 game.json、包结构及平台适配代码应优先由构建流程生成;未经确认直接改构建产物,下一次构建可能会覆盖修改。
用代码验证平台边界
把下面脚本保存为 PlatformProbe.ts,挂到两个构建共同使用的启动场景节点上。它只在浏览器中检查 DOM,不会因为小游戏没有普通网页的 document 而直接访问它。
import { _decorator, Component, sys } from 'cc';
const { ccclass } = _decorator;
@ccclass('PlatformProbe')
export class PlatformProbe extends Component {
start() {
const inWeChat = sys.platform === sys.Platform.WECHAT_GAME;
const name = inWeChat ? '微信小游戏' : sys.isBrowser ? 'Web浏览器' : '其他平台';
console.log(`[PlatformProbe] ${name}`);
// 网页 DOM 属于浏览器能力,小游戏逻辑不能无条件调用
if (sys.isBrowser) {
console.log(`[PlatformProbe] DOM=${typeof document !== 'undefined'}`);
}
}
}预期输出(Web Mobile 的浏览器控制台):
[PlatformProbe] Web浏览器
[PlatformProbe] DOM=true预期输出(微信小游戏开发者工具控制台):
[PlatformProbe] 微信小游戏其他目标平台会输出“其他平台”。sys.isBrowser 用于判断是否在浏览器中运行,而不是判断设备是不是手机;平台特有登录、分享等功能仍需走对应 SDK,并对不支持的环境提供替代行为。
资源和能力要按宿主验收
同样调用 Cocos 的资源管理接口,不代表两端的实际获取路径相同。Web 主要受服务器路径、跨域和浏览器缓存影响;小游戏还受平台包体限制、分包规则、资源下载及本地缓存策略约束。通过 Asset Bundle 可以将非首屏资源组织为本地、分包或远程资源,但小游戏分包与远程包不是同一个概念:分包必须符合对应平台规则,不能同时当作远程包配置。
验收时至少检查同一启动场景是否一致、首次下载是否完整、重复进入是否命中预期缓存,以及断网时是否有明确失败反馈。涉及登录、支付或分享的页面,要在目标平台真机验证;仅 Web 构建成功或开发者工具预览通过,都不能替代小游戏端发布前的实际验收。