游戏引擎 / 系统课时

怎样检查一次构建是否可发布

怎样检查一次构建是否可发布

构建日志显示成功,只能证明构建步骤完成,不能证明安装、首场景和平台能力已经通过。本节为产物设置文件、启动、功能和发布身份四道检查,并用一段独立脚本把缺少证据的构建拦在提交渠道之前。

学习目标

  • 将构建成功与目标环境验收分开记录。
  • 为一次发布收集与最终产物绑定的检查证据。
  • 用可执行规则阻止未经验证的产物进入提交阶段。

检查对象必须是最终产物

使用 Creator 3.8 LTS 的同一源码、精确编辑器版本和完整平台配置构建到独立目录。验收记录指向这份产物,不能拿上一次成功安装的包,也不能拿编辑器预览结果证明当前包可用。若验收后又改配置重打包,应产生新记录并重新检查。

Web 检查 HTTP 服务下的完整输出目录;Android 检查安装到目标设备的包;iOS 检查对应签名构建;小游戏检查渠道工具和真机容器中的对应项目。各路线的工具不同,核心要求相同:证据必须能追到同一份构建。

把检查分成连续的门

从构建产物到渠道提交的检查门

文件门确认入口、资源、原生库或渠道要求文件齐全,记录文件摘要。启动门在干净状态打开最终产物,确认首场景与首屏资源。能力门覆盖核心玩法及登录等目标能力,也检查取消、失败和断网后的行为。身份门核对版本、包标识、签名或渠道 AppID。

“文件存在”不能代替“内容正确”。例如 Web 入口存在但引用旧资源、Android 包能安装但使用测试服务,都需要停止发布。正式渠道还可能要求额外材料,项目的技术检查单不能替代目标渠道的当前提交要求。

用证据状态拦截提交

下面的完整示例只验证团队的检查记录,不会启动 Creator、安装应用或访问渠道。保存为 check-ready.cjs,使用 Node.js 18 或更高版本运行 node check-ready.cjs。实际接入时,状态必须来自对应检查结果,不能为了脚本通过直接填真。

js
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:

text
BLOCK: coreFlow

把 coreFlow 改为 true 后,预期输出为 READY: demo-42,退出码为 0。这是规则演示,生产记录还应校验产物摘要、测试设备、检查时间与报告位置,防止一份旧报告被套在新构建上。

最小验收记录写什么

每次至少保存构建编号、源码提交、Creator 精确版本、平台配置摘要、最终产物摘要、设备及系统版本、各检查结果和失败日志。成功截图可以辅助说明,但日志和可复现步骤更有助于判断资源缺失、权限失败或服务环境错误。

在目标设备冷启动后,执行一个完整主流程,再断网重试涉及网络的步骤,观察是否出现明确错误并能恢复。对移动端增加切后台再返回,对小游戏增加平台能力取消或拒绝。完成这些步骤并记录结果,才有资格把对应检查标为通过。

失败后只重跑受影响的证据

文件缺失先查输出目录和资源选择;首场景异常先查第一条加载失败与脚本错误;能力失败先查平台支持、账号与环境;身份不符则停止提交并重新构建。修复后的产物摘要变化时,应重新完成目标环境启动和相关功能检查。

练习保留一个失败构建及其报告,再生成修复版本,对比它们的构建编号、产物摘要与失败项。能够解释“哪个产物、在哪个环境、通过了哪些检查”,比单独一行构建成功日志更能支撑发布决定。

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

目录与阅读设置

阅读设置

17

记录一个想法

怎样检查一次构建是否可发布

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

登录哪都通