游戏引擎 / 系统课时
构建面板里的配置分别管什么
构建面板里的配置分别管什么
构建面板中相邻的开关可能分别影响运行平台、资源集合和产物位置,改错一项就会得到能构建却不能正确启动的包。本节把配置按职责拆开,并通过一次独立输出的测试构建验证每项设置的实际作用。
学习目标
- 区分平台选择、场景资源、运行选项和输出目录的职责。
- 用导出的平台配置保存一次构建,而不是靠截图记忆开关。
- 通过最终产物验证设置,区分编辑器预览与构建运行。
从一条最小构建任务开始
使用 Cocos Creator 3.8 LTS 打开一个至少包含一个可运行场景的项目,保存场景后进入菜单“项目 → 构建发布”(英文界面为 Project → Build)。快捷键为 Windows 的 Ctrl+Shift+B 或 macOS 的 Cmd+Shift+B。先选择 Web 桌面端作为检查目标。官方构建面板说明
平台决定构建插件和运行环境;构建输出位置决定文件写到哪里。即使两项都叫 Web,也应让测试任务使用独立目录,避免前一次遗留文件掩盖本次缺失资源。路径优先使用无空格、无中文的简单目录。
配置如何作用于产物

| 配置职责 | 需要回答的问题 | 常见误判 |
|---|---|---|
| 平台 | 产物交给哪个运行容器 | 手机浏览器与 Android 原生混为一谈 |
| 场景与资源 | 启动哪个场景,包含哪些依赖 | 首场景未勾选却只检查名称 |
| 运行选项 | 是否调试,如何命名缓存资源 | 开启 MD5 就认为 CDN 永远不会缓存旧入口 |
| 输出位置 | 本次生成文件落到哪里 | 多个任务复用目录后检查到旧文件 |
首场景必须从本次包含的场景中选择。普通场景引用会带入相应依赖;动态加载、resources 和 Asset Bundle 还需要按自己的组织方式检查,不能只靠首场景可见资源判断内容齐全。通用构建选项
保存能追溯的平台配置
构建面板的导入、导出操作针对当前平台配置。第一次配置完成后导出 JSON,并给文件名标明平台和用途。下面只是导出文件中部分通用字段的片段示例,依赖同一 Creator 版本导出的完整配置;请在原导出文件上核对字段,不用此片段覆盖它。
{
"platform": "web-desktop",
"debug": true,
"md5Cache": true
}预期行为是面向 Web 桌面端生成调试构建,并为相关资源启用 MD5 文件命名。debug 会影响调试和压缩方式;md5Cache 不能替代 HTTP 缓存策略。验证时查看本次构建日志、产物资源命名与最终页面的网络请求,而不是只看导出文件中的布尔值。
平台专属选项可能位于导出配置的 packages 中。原生签名、Web 地址和小游戏 AppID 不是一套可互换的字段;跨平台复制配置时应从目标平台重新导出,再迁移明确共有的设置。
用构建产物验证四个职责
- 选择一个本次包含的场景作为首场景,设置独立输出目录并执行构建。
- 确认构建任务成功,再使用面板的运行功能检查构建结果。
- 检查输出目录的本次文件,确认页面进入指定场景,资源请求没有缺失。
- 只修改一个可观测设置,再构建到新目录,比较变化是否符合预期。
编辑器的场景预览使用开发环境,不能证明导出后的路径与资源完整。若构建结果白屏,先检查运行服务、首场景和首次失败请求,再检查业务异常;若输出目录没有更新,先核对任务名称、目录和日志,不要立即修改游戏脚本。
最后保留完整导出配置及其对应构建记录。别人能够用同一 Creator 版本、同一源码和该配置复现一次构建,才说明面板设置已经变成可靠的发布输入。