游戏引擎 / 系统课时
打包并验证最终版本
打包并验证最终版本
最终版本不能只以“编辑器里能运行”为验收标准。本课把项目生成目标平台的 Shipping 包,并用独立可执行文件完成启动、核心流程、性能与资源完整性检查,最终得到一个可以进入发布环节的候选版本。
学习目标
- 使用 Unreal AutomationTool 生成目标平台的 Shipping 构建并确认打包成功。
- 在脱离编辑器的环境中验证启动、核心玩法、资源加载与退出流程。
- 建立最终版本的性能、稳定性和发布门禁,能判断问题应返工还是放行。
固定最终构建口径
最终验收要针对“准备交付给玩家的包”,而不是 PIE、Standalone Game 或 Development 构建。先在 Project Settings > Packaging 核对目标配置、默认地图、需要 Cook 的内容与项目实际发布策略,再清理旧输出目录,避免把上一次构建残留误认为本次产物。
如果最终发布目标是 Windows,常见口径是 Win64 + Shipping。Shipping 会启用发布优化,并限制面向开发阶段的控制台、统计和调试能力,因此深度性能分析应在 Test 或 Development 构建中完成,而最终 Shipping 包负责验证真实交付形态是否正常。

生成可交付的 Shipping 包
图形界面可以通过 Platforms 菜单选择目标平台并执行 Package Project;要让构建过程可复现,更适合把最终构建固定成 AutomationTool 命令。下面以 Windows 为例,先把三个占位路径替换为本机实际目录。
$UE_ROOT = "<UE_ROOT>"
$PROJECT = "<PROJECT_PATH>\MyGame.uproject"
$ARCHIVE = "<ARCHIVE_PATH>\MyGame-Win64-Shipping"
& "$UE_ROOT\Engine\Build\BatchFiles\RunUAT.bat" BuildCookRun `
-project="$PROJECT" `
-noP4 `
-platform=Win64 `
-clientconfig=Shipping `
-build -cook -stage -pak -package -archive `
-archivedirectory="$ARCHIVE"
if ($LASTEXITCODE -ne 0) {
throw "Packaging failed with exit code $LASTEXITCODE"
}
Write-Output "PACKAGING_OK archive=$ARCHIVE"预期输出
PACKAGING_OK archive=<ARCHIVE_PATH>\MyGame-Win64-Shipping<UE_ROOT>、<PROJECT_PATH> 与 <ARCHIVE_PATH> 的实际值因机器而异。命令成功只说明构建、Cook、Stage 与 Package 流程完成,不能替代运行验收;还要确认归档目录里存在目标平台的可执行文件和对应内容数据。
用独立包跑完整主流程
把归档目录复制到不依赖工程源码和编辑器的测试位置,再从可执行文件冷启动。这样能尽早发现“本机工程目录恰好提供了依赖”的假成功。至少从程序启动开始,连续走到一次可结束的玩法闭环。
建议按真实玩家顺序检查:启动与首屏、主菜单、进入默认关卡、输入与镜头、核心交互或战斗、胜负或关卡结束、返回菜单以及正常退出。项目包含存档时,还要执行一次保存、退出、重新启动和读取,确认最终包使用的存档路径与数据版本能够正常工作。
任何只在第一次启动出现的长时间黑屏、关卡未加载、输入失效或直接退出,都应先视为发布阻断问题,而不是“偶发现象”。修复后必须重新生成包并从冷启动重测,不能只回编辑器确认。
检查性能与稳定性
最终 Shipping 包的性能检查重点是“玩家拿到的构建有没有回归”。选择一套固定硬件、固定分辨率和固定场景,记录启动耗时、典型战斗或高负载场景的帧率与卡顿体感,并与此前认可的基线比较。测试过程中还要覆盖持续运行、频繁切关和反复返回菜单,观察是否出现崩溃、明显的内存增长或越来越严重的卡顿。
Shipping 构建通常不适合作为深度分析环境。若发现帧时间异常或稳定性回归,应在能使用统计命令和分析工具的 Test 或 Development 构建中复现,再使用 Unreal Insights、CPU/GPU 分析工具定位;修复完成后回到 Shipping 包重新验收。
核对资源与发布完整性
资源完整性要检查“能够进入”和“能够正确显示”两层。逐个进入所有计划发布的地图,触发关键武器、角色、UI、音频、特效、过场与本地化文本,尤其关注通过软引用、Data Asset、关卡流送或运行时加载得到的内容。这类资源最容易在 Cook 范围配置不完整时缺失。
同时确认包内没有明显不应发布的测试地图、临时素材和开发专用文件。若项目依赖电影文件、平台运行库、插件内容或额外配置,也要在干净环境验证它们随包可用,而不是依赖开发机上已经安装的组件。
最终放行可以用四个门禁判断:可执行文件能冷启动;核心玩法能从开始走到结束;目标硬件上的性能和稳定性达到基线;所有发布资源在独立包中可加载且表现正确。任何一项失败都应回到修复、重新打包和完整复测,只有四项全部通过的构建才应标记为 Release Candidate。