游戏引擎 / 系统课时
配置Cook与Package流程
配置Cook与Package流程
当项目在编辑器里已经能稳定运行,下一步不是直接“导出一个 exe”,而是把代码、资源和配置按目标平台转换并收集成可运行包。本课用 Windows 为例,把 Build、Cook、Stage、Package 和 Archive 串成一条可重复执行、可验证的发布链路。
学习目标
- 区分 Build、Cook、Stage、Package、Archive 各自解决的问题
- 配置目标平台、地图和资源输入,避免发布包遗漏必要内容
- 用 AutomationTool 执行完整打包,并验证最终产物能脱离编辑器运行
看懂从工程到发布包的链路
UE5 的打包并不是一个单独动作。Build 负责把 C++ 模块编译成目标平台可执行代码;Cook 把纹理、网格、蓝图等资产转换为目标平台可加载的数据;Stage 把可执行文件、Cook 后资源和配置复制到暂存目录;Package 再按平台规则组织容器与可分发结构;Archive 则把最终结果复制到指定归档目录。

理解这条链路后,排错会更直接:代码编译失败看 Build,资源格式或依赖失败看 Cook,文件没有进入发布目录看 Stage 或 Package,最终归档位置不对再检查 Archive,而不是把所有问题都笼统归为“打包失败”。
先固定目标平台与Cook输入
开始发布前,先在编辑器中确认项目本身有明确入口。Project Settings > Maps & Modes 中应设置正确的 Game Default Map;只在编辑器里手动打开、但没有被任何可 Cook 地图或资源引用的关卡,不应假定会自动进入发布包。
Project Settings > Packaging 里重点检查地图和额外资源目录。优先让资产通过地图、蓝图、数据资产或 Asset Manager 形成真实引用;只有确实需要按目录强制纳入时,再使用 Additional Asset Directories to Cook。目录规则过宽会增加 Cook 时间和包体积,也会掩盖错误引用。
构建配置也要与验证目标一致。Development 包保留更多诊断能力,适合首轮发布验证;Shipping 面向正式交付,会减少调试信息并采用更严格的发布配置。先让 Development 包完整跑通,再切到 Shipping,通常比直接在 Shipping 上排查高效。
用AutomationTool执行完整流程
编辑器里的 Package Project 适合人工发布;需要稳定复现、接入 CI 或保留命令记录时,可以直接调用 Unreal AutomationTool。下面命令以 Windows 为例,<UE_ROOT> 是 UE5 安装目录,<PATH> 是你本机的工程或输出根目录,实际值会不同。
& "<UE_ROOT>/Engine/Build/BatchFiles/RunUAT.bat" BuildCookRun `
-project="<PATH>/MyGame.uproject" `
-noP4 `
-platform=Win64 `
-clientconfig=Development `
-build -cook -stage -pak -package `
-archive -archivedirectory="<PATH>/PackageOutput"
"UATExitCode=$LASTEXITCODE"
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }预期输出
UATExitCode=0退出码为 0 只说明自动化任务完成,不等于游戏一定可玩。若命令失败,应从日志中找到最早出现的 Error,而不是只看最后一行的失败摘要;Cook 阶段的首个资源错误往往会引发后续一串级联错误。
验证归档结果能独立运行
打包完成后,先确认归档目录里确实存在游戏可执行文件,再从归档目录启动它。下面的 PowerShell 不依赖固定的中间目录层级,只查找最终归档中的 MyGame.exe。
$exe = Get-ChildItem "<PATH>/PackageOutput" -Filter "MyGame.exe" -Recurse |
Select-Object -First 1
if (-not $exe) { throw "MyGame.exe not found in archive" }
$exe.FullName
& $exe.FullName -log预期输出
<PATH>/PackageOutput/<PLATFORM_SUBDIR>/MyGame.exe启动后至少验证默认地图能加载、玩家能生成、核心输入有效,以及一条关键 Gameplay 流程能完成。最好再在没有打开 Unreal Editor 的环境中运行一次,避免误把编辑器缓存、开发目录或本机额外文件当成发布包依赖。
让发布流程保持可重复
稳定的发布配置应把“哪些地图、哪些资源、哪个平台、什么构建配置、输出到哪里”固定下来。不要每次依赖临时勾选或记忆操作;团队项目应把 Packaging、Maps & Modes、Asset Manager 等工程设置纳入版本控制,并用同一条 BuildCookRun 命令重复验证。
当 Development 包能够从干净目录完成 Cook、Package、启动和核心功能验收后,再切换 Shipping 做最终发布。这样得到的不是一次偶然成功的打包,而是一条可以在本机和 CI 上复现的交付流程。