游戏引擎 / 系统课时

小游戏构建和 Web 构建差在哪

小游戏构建和 Web 构建差在哪

Cocos Creator 3.8 的同一个场景可以分别构建为 Web 和小游戏,但产物不能互换运行。本课以 Web Mobile 和微信小游戏为例,对齐启动入口、运行容器、资源路径及平台 API,并用一个脚本验证边界。

学习目标

  • 说清 Web 页面启动与小游戏平台启动的根本区别。
  • 识别资源加载、缓存、分包及平台能力的适配边界。
  • 从同一场景构建并验证两个目标平台。

启动入口和运行容器不是同一套

Web 构建交给浏览器:Web 服务器提供 index.html 等文件,页面初始化画布和游戏脚本,浏览器负责网络、页面生命周期与 Web API。小游戏构建交给平台宿主:以微信小游戏为例,平台加载其项目入口 game.js,读取 game.json 等配置,由小游戏运行环境提供渲染、网络和生命周期接口。

Cocos 为小游戏提供适配层,让多数节点、组件和场景逻辑可复用;但小游戏不等于“没有地址栏的浏览器”。不能假设存在完整 DOM,也不能直接依赖任意浏览器插件。

普通Web与微信小游戏的启动宿主和资源链路对比

比较点 Web Mobile 微信小游戏
启动入口 浏览器访问网页及 index.html 平台加载 game.js、平台配置
运行环境 浏览器 DOM、Canvas、网络 API 平台沙箱和 Cocos 适配能力
资源来源 站点文件或远程服务器 本地包、小游戏分包、远程 Asset Bundle
平台服务 浏览器接口或另接 Web SDK 对应小游戏平台 SDK
排查工具 浏览器开发者工具与网络面板 微信开发者工具及真机调试

表中的“微信小游戏”是具体示例;抖音、OPPO 等平台的入口文件、限制和 SDK 并不完全相同,不能把微信规则直接复制到所有小游戏。

从同一场景各构建一次

在 Cocos Creator 的“项目 → 构建发布”新建两项任务,使用相同的启动场景和游戏内容,分别选择 Web Mobile 与 WeChat Mini Game(界面显示名称可能随语言和版本略有差异)。

  1. 构建 Web Mobile,使用编辑器预览或 HTTP 服务器访问完整 Web 产物,不要仅双击本地 HTML 文件。
  2. 构建微信小游戏,填写当前项目需要的小游戏 AppID,在微信开发者工具中打开对应构建目录并运行。
  3. 对比两个产物中的入口文件及资源目录,再在各自运行环境观察首屏和控制台。Web 包不应直接拿给小游戏平台作为发布包。

这是两种目标平台的独立构建,而非给 Web 文件改一个扩展名。小游戏端的 game.json、包结构及平台适配代码应优先由构建流程生成;未经确认直接改构建产物,下一次构建可能会覆盖修改。

用代码验证平台边界

把下面脚本保存为 PlatformProbe.ts,挂到两个构建共同使用的启动场景节点上。它只在浏览器中检查 DOM,不会因为小游戏没有普通网页的 document 而直接访问它。

ts
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 的浏览器控制台):

text
[PlatformProbe] Web浏览器
[PlatformProbe] DOM=true

预期输出(微信小游戏开发者工具控制台):

text
[PlatformProbe] 微信小游戏

其他目标平台会输出“其他平台”。sys.isBrowser 用于判断是否在浏览器中运行,而不是判断设备是不是手机;平台特有登录、分享等功能仍需走对应 SDK,并对不支持的环境提供替代行为。

资源和能力要按宿主验收

同样调用 Cocos 的资源管理接口,不代表两端的实际获取路径相同。Web 主要受服务器路径、跨域和浏览器缓存影响;小游戏还受平台包体限制、分包规则、资源下载及本地缓存策略约束。通过 Asset Bundle 可以将非首屏资源组织为本地、分包或远程资源,但小游戏分包与远程包不是同一个概念:分包必须符合对应平台规则,不能同时当作远程包配置。

验收时至少检查同一启动场景是否一致、首次下载是否完整、重复进入是否命中预期缓存,以及断网时是否有明确失败反馈。涉及登录、支付或分享的页面,要在目标平台真机验证;仅 Web 构建成功或开发者工具预览通过,都不能替代小游戏端发布前的实际验收。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

小游戏构建和 Web 构建差在哪

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通