游戏引擎 / 系统课时
建立可重复的版本发布流程
建立可重复的版本发布流程
发布时临时改版本、点击导出再压缩,容易让包、源码和验收记录对不上。本课把版本确定、构建、检查和归档串成有停止条件的流程,用独立哈希清单绑定最终产物,支持后续复现与回滚。
学习目标
- 能为发布步骤设置明确输入和停止条件
- 能把源码、工具版本与验收绑定到产物
- 能生成可复查的发布包哈希清单
冻结能复建的输入
发布前确定源码提交、引擎和模板版本、目标平台预设、插件与资源输入。工作区有未提交的临时修改时,应纳入明确版本或退出本轮构建,不能让登记的提交号指向不含实际修改的状态。外部素材或工具也需可追溯来源。
展示版本与构建编号由统一记录分配,检查渠道最后使用的编号。配置和密钥使用受控位置,构建日志不能回显口令。为每轮创建新的输出目录,构建失败不复用旧文件冒充结果;不要在预设之间手工复制无法追踪的临时参数。
每道门都有停止条件
先做资源和脚本检查,再正式导出;导出成功后检查产物身份、签名、版本和资源范围;再进行新装、升级、固定性能路线与设备功能验收。任何阻断项失败都停止进入下一道发布门,修复后以新构建重新开始受影响检查。

测试构建和待发构建应尽量一致。若验收后又重新导出正式包,即使源码没有变,也要确认差异、哈希和必要运行检查,不能直接沿用旧包成绩。对商店重新签名或拆分的产物,增加对应轨道验收。
用文件哈希绑定最终产物
以下 PowerShell 7 入口只读取一个已完成的发布目录,把 SHA256 清单写到目录之外。保存为 hash-release.ps1,传入 -PackageDir 和 -ManifestPath;它不导出、签名或上传任何包。
param(
[Parameter(Mandatory)][string]$PackageDir,
[Parameter(Mandatory)][string]$ManifestPath
)
$ErrorActionPreference = 'Stop'
$base = (Resolve-Path -LiteralPath $PackageDir).Path.TrimEnd('\')
$manifestFull = [IO.Path]::GetFullPath($ManifestPath)
if ($manifestFull.StartsWith($base + '\', [StringComparison]::OrdinalIgnoreCase)) {
throw 'Manifest must be outside package directory'
}
# 使用稳定相对路径;不把清单自己加入清单。
$files = @(Get-ChildItem -LiteralPath $base -File -Recurse | Sort-Object FullName)
if ($files.Count -eq 0) { throw 'Package is empty' }
$rows = @($files | ForEach-Object {
[pscustomobject]@{
path = $_.FullName.Substring($base.Length + 1).Replace('\', '/')
sha256 = (Get-FileHash -LiteralPath $_.FullName -Algorithm SHA256).Hash.ToLowerInvariant()
bytes = $_.Length
}
})
ConvertTo-Json -InputObject $rows -Depth 4 | Set-Content -LiteralPath $manifestFull -Encoding UTF8
Write-Output ('files=' + $files.Count)预期输出(文件数量随真实目录变化):
files=<COUNT>清单始终为 JSON 数组,只有一个文件时也保持数组结构。每项包含路径、哈希与字节数,供后续比较。输出目录必须是完整发布包,清单输出父目录要存在;清单不证明可运行或没有秘密,只证明这些字节的身份。归档压缩后解压并重新比对,检查打包环节没有遗漏或更改。
把记录和停止原因一起归档
保存提交、工具版本、预设、构建日志、签名证书标识、哈希清单、设备矩阵与发布说明。敏感凭据单独保管,归档记录只标识来源和访问责任。失败项保留原始错误、负责人和状态,已知问题必须是明确接受的范围,而非漏掉的验收。
回滚准备要包含上一份可用产物、兼容的用户数据处理和平台版本编号方案。Android 通常用更高编号发布恢复内容,不假设可以直接降级安装旧包。联网服务与存档格式变更也要核对,回退代码不一定能回退数据。
最后核对实际提交的文件
最终批准前,确认准备提交的字节与验收记录一致,目标渠道与签名正确,所有必测设备和阻断项已有结论。上传或公开分发是流程最后的动作,生成清单不代表已经发布。每轮都保留这个对应关系,发布后问题才能准确落到某个构建。
导出自动化输入见 Command line tutorial,升级编号边界见 Version your app。