游戏引擎 / 系统课时

整理上线前的 3D 检查清单

整理上线前的 3D 检查清单

本课把 3D 游戏上线前容易遗漏的资源、性能、操作和异常风险整理成可执行的验收清单。你将基于真正准备发布的构建产物逐项核验,留下可复查的证据,并设置明确的发布阻断条件,避免编辑器里能运行、玩家设备上却出问题。

学习目标

  • 能为资源、性能、输入、UI、音频、兼容性和异常日志制定可验证的检查项。
  • 能在目标设备上执行正式包回归,记录结果和证据。
  • 能使用轻量脚本拒绝缺项、失败或缺少证据的发布报告。

先固定受测版本

在 Cocos Creator 3.8 中,通过“项目 → 构建”选择实际交付的平台,生成候选包。Web 端可从构建任务运行产物,原生端则应安装生成的应用到目标真机;不要把编辑器预览结果当成发布验收。操作细节可参考官方构建面板说明。

为候选包记录版本号、代码提交、构建配置、目标平台、构建产物标识。同时确定目标设备档位与验收预算,例如帧时间上限、峰值内存、首屏等待时间和包体大小。阈值要依据项目要求确定,不应把某个设备上的偶然流畅当作通用标准。

检查清单还需要明确执行人、测试环境、预期行为、实际结果和证据位置。构建成功只意味着产物生成,不代表七类质量检查已经通过。如果测试期间修改了脚本、资源或构建设置,就必须重新生成候选包并确定需要重新执行的测试。

七类检查项与通过条件

类别 在正式包上做什么 判定与证据
资源 检查首场景、模型材质、贴图、动画、动态 Prefab;反复进入退出场景至少五次 无缺失资源、材质异常或加载失败;保存加载日志与切场记录
性能 在最低支持档设备上跑最重场景与连续玩法,记录帧时间、Draw Call、内存和 GC 关键指标未突破预定预算;保存设备型号、场景和采样结果
输入 实测支持的键鼠或触控操作、按下与抬起、暂停恢复和失焦返回 不出现卡键、重复触发、误触或失去操作;保存操作录屏
UI 查看宽窄屏、安全区域、HUD、菜单、结算页和错误提示 关键信息可见可点,无裁切和遮挡;保存典型分辨率截图
音频 检查背景音乐、一次性音效、静音、暂停、恢复及切场 无异常叠播、持续残留或应播不播;记录各场景结果
兼容性 覆盖支持的系统版本和设备档位;做冷启动、后台返回、断网恢复 无崩溃或阻塞主流程,异常路径有合理反馈;保存设备矩阵
异常日志 查看构建日志、浏览器控制台或真机运行日志,并复查故障路径 无未处理异常及阻断性资源错误;保留脱敏日志和缺陷编号

资源检查不只看模型能否显示,还要确认异步加载和释放的时机正确。例如连续切换大厅与战斗场景后,已退出场景的节点应被销毁,不再使用的资源引用应按设计释放。观察内存是否趋于稳定,不能仅凭一次切场成功就认为不存在泄漏。

性能检查需要有可重复的负载条件,例如相同角色数量、相机视角、粒子数量和运行时长。对于以 30 FPS 为目标的设备,单帧预算约为 33.3 ms,但实际验收还应关注高分位帧时间和连续卡顿;不能只看平均 FPS。包体、内存和温升也要根据发布平台分别设定标准。

按阻断闭环完成验收

先跑一条最短的玩家主链:冷启动 → 进入场景 → 移动与交互 → 触发 UI 和音效 → 完成一局 → 重新开始 → 返回或退出。然后覆盖场景反复切换、快速操作、低性能设备以及中断恢复等高风险条件。

发布候选版本的验收与返工闭环

建议按以下顺序执行,并在每个阶段补充记录:

  1. 构建核对:确认平台、入口场景、版本信息及发布配置正确,保存构建日志和产物标识。
  2. 主链烟雾测试:从正式包启动,验证最基本的进入、操作、结算和退出流程,确保没有阻断性故障。
  3. 专项压力与兼容测试:在设备矩阵上运行复杂场景、反复切场、异常网络及后台恢复场景,采集真实性能数据。
  4. 缺陷处理与回归:记录复现步骤和严重程度,修复后使用新包复测,确认问题消失且原有功能没有退化。
  5. 签收与归档:全部强制项目通过后,由负责人确认剩余风险及发布范围,保存与候选包对应的证据。

验收时将每项标为通过、失败或未验证,并关联设备信息、复现步骤和证据。崩溃、核心操作失效、资源缺失、明确超出性能预算、未处理异常等情况应直接阻断发布;一般警告要分析影响并记录处理决定,不能只凭日志条数判定。

如果修复问题需要重新构建,应给新产物新的标识,重新执行主链烟雾测试及受影响项目回归。旧包的测试记录不能自动为新包签收,否则检查清单只是形式上的打勾。

用脚本阻止漏检放行

人工验收表可以再接一个发布闸门:七类检查必须齐全,状态为 pass 且证据字段不为空。下面是 Node.js 18+ 的完整示例,不依赖 Cocos 编辑器插件;它只检查报告记录是否完整,不能代替真机测量,也无法辨认证据真假。

将脚本保存为 release-gate.mjs:

js
import { readFileSync } from 'node:fs';

const required = ['资源', '性能', '输入', 'UI', '音频', '兼容性', '异常日志'];
const file = process.argv[2];

if (!file) {
  console.error('用法:node release-gate.mjs release-checks.json');
  process.exit(2);
}

const report = JSON.parse(readFileSync(file, 'utf8'));
// 缺项、未通过或缺证据都阻断发布
const blocked = required.filter((name) => {
  const item = report[name];
  return item?.status !== 'pass' ||
    typeof item?.evidence !== 'string' ||
    item.evidence.trim().length === 0;
});

if (blocked.length > 0) {
  console.error(`阻断发布:${blocked.join('、')}`);
  process.exitCode = 1;
} else {
  // 只说明记录满足门禁,不证明真实质量
  console.log(`放行:${required.length} 项检查均有通过记录与证据`);
}

保存一份演示用 release-checks.json。其中状态和文字仅说明格式,正式发布必须替换为真实测试记录:

json
{
  "资源": {"status": "pass", "evidence": "加载及五次切场检查记录"},
  "性能": {"status": "pass", "evidence": "低配机帧时间和内存统计"},
  "输入": {"status": "pass", "evidence": "键鼠及触控回归记录"},
  "UI": {"status": "pass", "evidence": "安全区与分辨率截图"},
  "音频": {"status": "pass", "evidence": "静音、暂停与切场记录"},
  "兼容性": {"status": "pass", "evidence": "目标设备矩阵"},
  "异常日志": {"status": "fail", "evidence": "冷启动存在未处理异常"}
}

在两个文件所在目录执行:

bash
node release-gate.mjs release-checks.json

预期输出(进程退出码为 1):

text
阻断发布:异常日志

由于异常日志一项仍处于 fail 状态,脚本会阻止放行。修复异常后,应重新构建并复测,在报告中更新真实证据与 pass 状态;只有七项都通过且具有证据,程序才会输出放行信息并以退出码 0 结束。这一退出码也可以交给持续集成流水线作为后续发布步骤的前置条件。

正式交付时,一并归档发布产物、构建配置、设备矩阵、性能数据、异常日志和签收记录。清单最重要的价值不是证明团队完成了多少次测试,而是让每一项放行决定都能对应到具体版本、实际设备和可复核的证据。

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

目录与阅读设置

阅读设置

17

记录一个想法

整理上线前的 3D 检查清单

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

登录哪都通