游戏引擎 / 系统课时
检查发布前的项目配置
检查发布前的项目配置
这一课用 Cocos Creator 3.8 的发布前检查清单,防止游戏构建成功后出现横竖屏错误、启动场景不对、资源丢失或调试包误发布。完成后可以得到一份可逐项验收的小游戏构建配置记录。
学习目标
- 核对分辨率、屏幕适配与小游戏平台方向是否一致。
- 检查启动场景、参与构建的场景及动态资源是否完整。
- 在正式构建前验证调试开关,并用运行时日志交叉检查配置。
先确定交付目标
先写清目标平台、横屏还是竖屏、入口场景名称和预期设计分辨率。本课以微信小游戏、竖屏、入口场景 Main、设计分辨率 720×1280为示例,这些是演示项目的约定,不是 Cocos Creator 的通用默认值。
在编辑器打开“项目 → 项目设置(Project Settings)”及“项目 → 构建发布(Build)”。前者管理工程级默认设置,后者决定这次生成的目标平台和实际打包范围。不要把编辑器当前预览场景误认为发布启动场景。
检查画面适配与方向
在 Project Settings 的 Project Data 中核对默认 Canvas 的设计分辨率和适配策略,再用不同屏幕比例预览实际 UI。默认 Canvas 设置不能代替对已有场景布局的检查,尤其要观察按钮、边缘 HUD 和全面屏安全区域。
| 检查项 | 合格标准 |
|---|---|
| 设计分辨率 | 与项目约定一致;本例为 720×1280 |
| 屏幕适配 | 不同长宽比下,关键 UI 不被裁切或遮挡 |
| 横竖屏方向 | 构建平台的 Orientation 与产品设计相符 |
| 安全区域 | 顶部信息、返回按钮不与刘海或系统区域冲突 |
对于微信小游戏,在 Build 面板选定对应平台后检查其 Orientation。方向选项是平台构建配置,与画布设计分辨率不是同一件事;只改其中一个,仍可能出现旋转或显示区域异常。
核对入口场景和资源范围
在 Build 面板的 Included Scenes 中确认 Main 已被勾选并被设为 Start Scene,后续通过 director.loadScene() 切换到的场景也必须参与构建。只在编辑器预览中打开某个场景,并不会自动证明发布包从它启动。

对资源做两类检查:场景中直接引用的 Prefab、贴图、字体等能否被正确带入;脚本动态加载的资源是否位于可用的 resources 目录或已参与构建的 Asset Bundle 中。如果使用远程 Bundle,还要核对远端发布地址、资源上传与设备联网条件,不能只验证本地预览。
用运行日志交叉验证
以下组件只校验运行时场景名称与设计分辨率。新建 ReleasePreflight.ts,挂到预期启动场景 Main 的启用节点上,保存场景后运行构建产物。这里的判断值应按自己的发布基线修改。
import { _decorator, Component, director, log, view } from 'cc';
const { ccclass } = _decorator;
@ccclass('ReleasePreflight')
export class ReleasePreflight extends Component {
start(): void {
const scene = director.getScene()?.name ?? 'NONE';
const size = view.getDesignResolutionSize();
// 这两个条件应与本次构建的发布基线逐项对应。
const valid = scene === 'Main'
&& size.width === 720
&& size.height === 1280;
// 只输出观测结果,不在运行时改变发布配置。
log(`[preflight] scene=${scene}`);
log(`[preflight] design=${size.width}x${size.height}`);
log(`[preflight] ${valid ? 'PASS' : 'CHECK'}`);
}
}预期输出(入口场景确为 Main 且设计分辨率为 720×1280 时):
[preflight] scene=Main
[preflight] design=720x1280
[preflight] PASS如果不是这组设置,结果将显示实际值并提示 CHECK。这段代码只能证明组件执行时的场景和设计分辨率,不能替代对 Start Scene、横竖屏、资源和打包选项的检查;必须从目标平台冷启动验证,不要只运行编辑器当前场景。
用正式配置构建并验收
在 Build 面板核对平台身份信息(如微信小游戏的 AppID)、参与构建的场景和 Bundle,并确认正式包的 Debug Mode 已关闭。需要定位问题时可以另存调试构建配置,不要把调试包当作正式交付包。记录构建任务名称与产物位置,避免误上传旧包。
最后在目标平台开发者工具和至少一台真实设备上冷启动,检查首屏、场景切换、资源加载、横竖屏与异形屏布局、音频及触摸交互;对错误日志和加载失败逐项处理。构建完成仅表示产物已生成,发布前验收通过才表示这套配置可交付。