游戏引擎 / 系统课时

建立可重复的版本发布流程

建立可重复的版本发布流程

发布时临时改版本、点击导出再压缩,容易让包、源码和验收记录对不上。本课把版本确定、构建、检查和归档串成有停止条件的流程,用独立哈希清单绑定最终产物,支持后续复现与回滚。

学习目标

  • 能为发布步骤设置明确输入和停止条件
  • 能把源码、工具版本与验收绑定到产物
  • 能生成可复查的发布包哈希清单

冻结能复建的输入

发布前确定源码提交、引擎和模板版本、目标平台预设、插件与资源输入。工作区有未提交的临时修改时,应纳入明确版本或退出本轮构建,不能让登记的提交号指向不含实际修改的状态。外部素材或工具也需可追溯来源。

展示版本与构建编号由统一记录分配,检查渠道最后使用的编号。配置和密钥使用受控位置,构建日志不能回显口令。为每轮创建新的输出目录,构建失败不复用旧文件冒充结果;不要在预设之间手工复制无法追踪的临时参数。

每道门都有停止条件

先做资源和脚本检查,再正式导出;导出成功后检查产物身份、签名、版本和资源范围;再进行新装、升级、固定性能路线与设备功能验收。任何阻断项失败都停止进入下一道发布门,修复后以新构建重新开始受影响检查。 可重复发布的检查门与归档关系

测试构建和待发构建应尽量一致。若验收后又重新导出正式包,即使源码没有变,也要确认差异、哈希和必要运行检查,不能直接沿用旧包成绩。对商店重新签名或拆分的产物,增加对应轨道验收。

用文件哈希绑定最终产物

以下 PowerShell 7 入口只读取一个已完成的发布目录,把 SHA256 清单写到目录之外。保存为 hash-release.ps1,传入 -PackageDir 和 -ManifestPath;它不导出、签名或上传任何包。

powershell
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)

预期输出(文件数量随真实目录变化):

text
files=<COUNT>

清单始终为 JSON 数组,只有一个文件时也保持数组结构。每项包含路径、哈希与字节数,供后续比较。输出目录必须是完整发布包,清单输出父目录要存在;清单不证明可运行或没有秘密,只证明这些字节的身份。归档压缩后解压并重新比对,检查打包环节没有遗漏或更改。

把记录和停止原因一起归档

保存提交、工具版本、预设、构建日志、签名证书标识、哈希清单、设备矩阵与发布说明。敏感凭据单独保管,归档记录只标识来源和访问责任。失败项保留原始错误、负责人和状态,已知问题必须是明确接受的范围,而非漏掉的验收。

回滚准备要包含上一份可用产物、兼容的用户数据处理和平台版本编号方案。Android 通常用更高编号发布恢复内容,不假设可以直接降级安装旧包。联网服务与存档格式变更也要核对,回退代码不一定能回退数据。

最后核对实际提交的文件

最终批准前,确认准备提交的字节与验收记录一致,目标渠道与签名正确,所有必测设备和阻断项已有结论。上传或公开分发是流程最后的动作,生成清单不代表已经发布。每轮都保留这个对应关系,发布后问题才能准确落到某个构建。

导出自动化输入见 Command line tutorial,升级编号边界见 Version your app。

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

目录与阅读设置

记录一个想法

建立可重复的版本发布流程

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

登录哪都通