游戏引擎 / 系统课时

检查发布前的项目配置

检查发布前的项目配置

这一课用 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 的启用节点上,保存场景后运行构建产物。这里的判断值应按自己的发布基线修改。

ts
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 时):

text
[preflight] scene=Main
[preflight] design=720x1280
[preflight] PASS

如果不是这组设置,结果将显示实际值并提示 CHECK。这段代码只能证明组件执行时的场景和设计分辨率,不能替代对 Start Scene、横竖屏、资源和打包选项的检查;必须从目标平台冷启动验证,不要只运行编辑器当前场景。

用正式配置构建并验收

在 Build 面板核对平台身份信息(如微信小游戏的 AppID)、参与构建的场景和 Bundle,并确认正式包的 Debug Mode 已关闭。需要定位问题时可以另存调试构建配置,不要把调试包当作正式交付包。记录构建任务名称与产物位置,避免误上传旧包。

最后在目标平台开发者工具和至少一台真实设备上冷启动,检查首屏、场景切换、资源加载、横竖屏与异形屏布局、音频及触摸交互;对错误日志和加载失败逐项处理。构建完成仅表示产物已生成,发布前验收通过才表示这套配置可交付。

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

目录与阅读设置

阅读设置

17

记录一个想法

检查发布前的项目配置

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

登录哪都通