游戏引擎 / 系统课时
怎样检查一次构建是否可发布
怎样检查一次构建是否可发布
构建日志显示成功,只能证明构建步骤完成,不能证明安装、首场景和平台能力已经通过。本节为产物设置文件、启动、功能和发布身份四道检查,并用一段独立脚本把缺少证据的构建拦在提交渠道之前。
学习目标
- 将构建成功与目标环境验收分开记录。
- 为一次发布收集与最终产物绑定的检查证据。
- 用可执行规则阻止未经验证的产物进入提交阶段。
检查对象必须是最终产物
使用 Creator 3.8 LTS 的同一源码、精确编辑器版本和完整平台配置构建到独立目录。验收记录指向这份产物,不能拿上一次成功安装的包,也不能拿编辑器预览结果证明当前包可用。若验收后又改配置重打包,应产生新记录并重新检查。
Web 检查 HTTP 服务下的完整输出目录;Android 检查安装到目标设备的包;iOS 检查对应签名构建;小游戏检查渠道工具和真机容器中的对应项目。各路线的工具不同,核心要求相同:证据必须能追到同一份构建。
把检查分成连续的门

文件门确认入口、资源、原生库或渠道要求文件齐全,记录文件摘要。启动门在干净状态打开最终产物,确认首场景与首屏资源。能力门覆盖核心玩法及登录等目标能力,也检查取消、失败和断网后的行为。身份门核对版本、包标识、签名或渠道 AppID。
“文件存在”不能代替“内容正确”。例如 Web 入口存在但引用旧资源、Android 包能安装但使用测试服务,都需要停止发布。正式渠道还可能要求额外材料,项目的技术检查单不能替代目标渠道的当前提交要求。
用证据状态拦截提交
下面的完整示例只验证团队的检查记录,不会启动 Creator、安装应用或访问渠道。保存为 check-ready.cjs,使用 Node.js 18 或更高版本运行 node check-ready.cjs。实际接入时,状态必须来自对应检查结果,不能为了脚本通过直接填真。
const record = {
buildId: 'demo-42',
checks: { files: true, coldStart: true, coreFlow: false, identity: true }
};
const required = ['files', 'coldStart', 'coreFlow', 'identity'];
// 缺字段、假值或字符串 "true" 都不算已通过。
const failed = required.filter(name => record.checks[name] !== true);
if (!record.buildId || failed.length) {
console.log('BLOCK: ' + failed.join(','));
process.exitCode = 1;
} else {
console.log('READY: ' + record.buildId);
}预期输出,进程退出码为 1:
BLOCK: coreFlow把 coreFlow 改为 true 后,预期输出为 READY: demo-42,退出码为 0。这是规则演示,生产记录还应校验产物摘要、测试设备、检查时间与报告位置,防止一份旧报告被套在新构建上。
最小验收记录写什么
每次至少保存构建编号、源码提交、Creator 精确版本、平台配置摘要、最终产物摘要、设备及系统版本、各检查结果和失败日志。成功截图可以辅助说明,但日志和可复现步骤更有助于判断资源缺失、权限失败或服务环境错误。
在目标设备冷启动后,执行一个完整主流程,再断网重试涉及网络的步骤,观察是否出现明确错误并能恢复。对移动端增加切后台再返回,对小游戏增加平台能力取消或拒绝。完成这些步骤并记录结果,才有资格把对应检查标为通过。
失败后只重跑受影响的证据
文件缺失先查输出目录和资源选择;首场景异常先查第一条加载失败与脚本错误;能力失败先查平台支持、账号与环境;身份不符则停止提交并重新构建。修复后的产物摘要变化时,应重新完成目标环境启动和相关功能检查。
练习保留一个失败构建及其报告,再生成修复版本,对比它们的构建编号、产物摘要与失败项。能够解释“哪个产物、在哪个环境、通过了哪些检查”,比单独一行构建成功日志更能支撑发布决定。