游戏引擎 / 系统课时

完成一次发布前综合检查

完成一次发布前综合检查

准备发布时,把零散的性能记录、设备验收和构建信息集中到同一个产物上,才能知道还缺什么。本课建立最终证据清单和阻断门,用程序拒绝未执行项目,再由实际记录判断是否可以进入发布。

学习目标

  • 能把验收证据绑定到唯一构建
  • 能让缺失、失败和未测状态阻止发布门通过
  • 能完成一次从产物到设备证据的综合核对

给这次检查唯一的对象

选择准备提交的最终包,记录哈希、平台架构、版本编号、展示版本、签名渠道、源码提交与工具链。不要在检查过程中悄悄替换包;一旦重新导出或补资源,就作为新构建更新身份和受影响记录。

准备性能基线、资源自检、设备矩阵、升级结果、日志与已知问题。每项证据标明构建、设备、工具、日期和测试路线,没有这些信息的“通过”无法对应当前包。某项只做了源码检查,状态必须描述源码范围,不能写成正式包完整通过。

如果目标平台缺真机、SDK、签名或图形测量,继续完成能做的检查,同时明确缺项。编译检查不能替代 GPU、长测和商店分发验收。发布门处理的是证据完整性,不应为得到绿色状态把未测项目改成通过。

让检查清单默认拒绝缺项

保存 checks.json,用以下结构记录五类必需检查。这里全部为未执行初始值,evidence 后续填写实际记录标识;它不是一次通过结果。

json
[
  {"name":"identity","status":"NOT_RUN","evidence":""},
  {"name":"resources","status":"NOT_RUN","evidence":""},
  {"name":"performance","status":"NOT_RUN","evidence":""},
  {"name":"device","status":"NOT_RUN","evidence":""},
  {"name":"upgrade","status":"NOT_RUN","evidence":""}
]

保存完整 PowerShell 7 入口 release-gate.ps1,用 -ChecksPath 指定该 JSON。实际运行前在项目中明确定义每类通过标准,脚本只核对记录状态,不能验证记录内容是否真实。

powershell
param([Parameter(Mandatory)][string]$ChecksPath)
$ErrorActionPreference = 'Stop'
$rows = @(Get-Content -Raw -Encoding UTF8 -LiteralPath $ChecksPath | ConvertFrom-Json)
$required = @('identity', 'resources', 'performance', 'device', 'upgrade')
$blocked = @()
foreach ($name in $required) {
    $checkRows = @($rows | Where-Object { $_.name -eq $name })
    # 缺项、重复、未通过或没有证据都不能放行。
    if ($checkRows.Count -ne 1 -or $checkRows[0].status -ne 'PASS' -or $checkRows[0].evidence -isnot [string] -or [string]::IsNullOrWhiteSpace($checkRows[0].evidence)) {
        $blocked += $name
    }
}
if ($blocked.Count -gt 0) {
    Write-Output ('blocked=' + ($blocked -join ','))
    exit 1
}
Write-Output 'release_ready=true'
exit 0

预期输出(使用上面的未执行清单,退出码为一):

text
blocked=identity,resources,performance,device,upgrade

只有必需项各有一条、状态通过且有证据标识时,才输出准备完成。测试中可以用人工数据验证这个分支,但不能将人工通过项当成设备验收。产品允许某个平台不做升级时,应在审批后的检查定义中处理适用性,而非偷偷删除必需项。

逐项核对证据覆盖范围

身份项核对包名、版本、哈希与签名,资源项在正式包遍历动态清单;性能项使用对应设备、尺寸和固定路线,包含切换峰值与持续阶段;设备项覆盖输入、音频、权限、联网和后台恢复;升级项验证原有存档迁移与再次保存。

比较当前记录与支持设备范围,检查是否缺最低配置、某种架构或系统版本。验证日志与失败关闭记录,没有解决的阻断项继续保持失败。对于已接受的非阻断问题,写清影响和发布范围,不能将其从记录中消失。

用最终包重跑关键路线

从干净目录或指定渠道安装最终包,冷启动进入关卡,使用最繁忙操作,保存、切后台、恢复、退出、重启。确认包身份与记录相同,检查存档、画面、音频与异常日志。压缩归档后的包也需要解压复核,防止交付过程漏文件。

若这一轮发现问题,保存失败证据并生成新构建修复,重新核对受影响项。签名、平台插件或资源过滤变更通常影响更多范围,应按依赖扩大复测;纯文案变更也至少确认最终包身份与相关显示。不要继续使用先前不同哈希包的完整通过标签。

把待完成与可发布分清

最后归档包、哈希、工具版本、清单、设备记录与已知问题,并列出仍需执行的实际操作。程序门通过只是记录结构满足条件,发布负责人还需确认来源与证据真实性。上传与公开分发属于后续动作,本课的结果是可审查的发布结论,不能自动宣称商店审核或所有设备已通过。

构建输入与产物范围见 Exporting projects,实际分发检查见 bundletool。

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

目录与阅读设置

记录一个想法

完成一次发布前综合检查

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

登录哪都通