游戏引擎 / 系统课时
完成发布前功能检查
完成发布前功能检查
发布前的最后检查应针对实际构建产物,覆盖正常闭环和失败恢复,而不是只确认编辑器没有红字。本节建立可记录的验收清单,并用启动自检提前发现关键节点引用缺失。
学习目标
- 按游戏闭环组织功能验收
- 为异常与重开路径记录结果
- 区分启动自检与完整发布验收
用同一产物走完核心路径
固定构建版本、目标平台、设备与资源版本,从冷启动进入 Menu,再开始一局。检查角色移动、碰撞阻挡、攻击去重、拾取计分、血条、暂停恢复、胜负结算和重开。每项记录步骤、预期、实际与证据;“大概玩了一下”不能说明哪条链路已通过。
| 路径 | 必须观察的结果 |
|---|---|
| 冷启动到开始 | 正确初始场景,无旧局状态 |
| 暂停与恢复 | 玩法停止且 UI 可用,恢复无卡键 |
| 胜利或死亡 | 只结算一次,结束后不再受伤或刷怪 |
| 连续重开 | 分数、生命、对象池与监听正确重置 |
| 加载失败 | 有反馈与可用的退出或重试入口 |
| 前后台切换 | 输入、音频、计时和显示符合规则 |
先在开发构建定位错误,再对拟发布产物重复验收。调试开关、日志级别或资源地址变化后,旧包的测试结论不能自动覆盖新包。
给关键配置增加启动自检
保存 ReleasePreflight.ts,挂到 Game 场景空节点,绑定 player 与 startButton。Player 需要 Sprite 和非空 SpriteFrame;按钮需要处于激活层级。该探针检查当前配置,不声称自动验证玩法或平台审核。
import { _decorator, Component, Node, Sprite, Button, director } from 'cc';
const { ccclass, property } = _decorator;
@ccclass('ReleasePreflight')
export class ReleasePreflight extends Component {
@property(Node) player: Node | null = null;
@property(Button) startButton: Button | null = null;
start(): void {
const failures: string[] = [];
if (director.getScene()?.name !== 'Game') failures.push('unexpected scene');
if (!this.player?.isValid) failures.push('missing player');
else if (!this.player.getComponent(Sprite)?.spriteFrame) failures.push('missing player spriteFrame');
if (!this.startButton?.isValid || !this.startButton.node.activeInHierarchy) failures.push('missing active button');
// 汇总配置问题,避免只看到最后一个空引用
if (failures.length) console.error('preflight:FAIL', failures);
else console.log('preflight:PASS');
}
}预期结果:满足这些条件时输出 preflight:PASS;故意清空 player 或其 SpriteFrame 后出现 preflight:FAIL 与对应原因。PASS 只代表这几项当前配置检查通过,不能替代碰撞、性能、资源失败和真机操作测试。
把阻断问题留在发布之前
针对目标设备检查屏幕安全区、触摸命中、最低性能场景与多轮进出后的内存稳定性。验证首次加载、缓存后加载和网络不可用时的反馈;依赖平台登录、支付或广告时,单独按平台测试环境验证合法流程,不能只用本地成功日志代替。
清理测试场景入口、无关大资源、临时调试线框与强制成功开关,保留必要错误日志和版本信息。核对商店或平台所需的图标、包标识、签名及隐私配置与实际功能一致,保存可回退的上一份产物和配置记录。
发现阻断故障后修复、重新构建并重跑受影响路径,不能修改检查表把失败改成通过。最终交付一份带产物标识与实际结果的记录,让下一次更新可以复用同一套验证步骤。