游戏引擎 / 系统课时
完成一次发布前综合检查
完成一次发布前综合检查
准备发布时,把零散的性能记录、设备验收和构建信息集中到同一个产物上,才能知道还缺什么。本课建立最终证据清单和阻断门,用程序拒绝未执行项目,再由实际记录判断是否可以进入发布。
学习目标
- 能把验收证据绑定到唯一构建
- 能让缺失、失败和未测状态阻止发布门通过
- 能完成一次从产物到设备证据的综合核对
给这次检查唯一的对象
选择准备提交的最终包,记录哈希、平台架构、版本编号、展示版本、签名渠道、源码提交与工具链。不要在检查过程中悄悄替换包;一旦重新导出或补资源,就作为新构建更新身份和受影响记录。
准备性能基线、资源自检、设备矩阵、升级结果、日志与已知问题。每项证据标明构建、设备、工具、日期和测试路线,没有这些信息的“通过”无法对应当前包。某项只做了源码检查,状态必须描述源码范围,不能写成正式包完整通过。
如果目标平台缺真机、SDK、签名或图形测量,继续完成能做的检查,同时明确缺项。编译检查不能替代 GPU、长测和商店分发验收。发布门处理的是证据完整性,不应为得到绿色状态把未测项目改成通过。
让检查清单默认拒绝缺项
保存 checks.json,用以下结构记录五类必需检查。这里全部为未执行初始值,evidence 后续填写实际记录标识;它不是一次通过结果。
[
{"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。实际运行前在项目中明确定义每类通过标准,脚本只核对记录状态,不能验证记录内容是否真实。
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预期输出(使用上面的未执行清单,退出码为一):
blocked=identity,resources,performance,device,upgrade只有必需项各有一条、状态通过且有证据标识时,才输出准备完成。测试中可以用人工数据验证这个分支,但不能将人工通过项当成设备验收。产品允许某个平台不做升级时,应在审批后的检查定义中处理适用性,而非偷偷删除必需项。
逐项核对证据覆盖范围
身份项核对包名、版本、哈希与签名,资源项在正式包遍历动态清单;性能项使用对应设备、尺寸和固定路线,包含切换峰值与持续阶段;设备项覆盖输入、音频、权限、联网和后台恢复;升级项验证原有存档迁移与再次保存。
比较当前记录与支持设备范围,检查是否缺最低配置、某种架构或系统版本。验证日志与失败关闭记录,没有解决的阻断项继续保持失败。对于已接受的非阻断问题,写清影响和发布范围,不能将其从记录中消失。
用最终包重跑关键路线
从干净目录或指定渠道安装最终包,冷启动进入关卡,使用最繁忙操作,保存、切后台、恢复、退出、重启。确认包身份与记录相同,检查存档、画面、音频与异常日志。压缩归档后的包也需要解压复核,防止交付过程漏文件。
若这一轮发现问题,保存失败证据并生成新构建修复,重新核对受影响项。签名、平台插件或资源过滤变更通常影响更多范围,应按依赖扩大复测;纯文案变更也至少确认最终包身份与相关显示。不要继续使用先前不同哈希包的完整通过标签。
把待完成与可发布分清
最后归档包、哈希、工具版本、清单、设备记录与已知问题,并列出仍需执行的实际操作。程序门通过只是记录结构满足条件,发布负责人还需确认来源与证据真实性。上传与公开分发属于后续动作,本课的结果是可审查的发布结论,不能自动宣称商店审核或所有设备已通过。
构建输入与产物范围见 Exporting projects,实际分发检查见 bundletool。