SuperAPI AI 工具集

unreal-packaging

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:把 UE5 项目变成可运行、可分发的构建产物,包括选择构建配置、烘焙内容、设置启动地图并打包,可在编辑器内或命令行完成。适用于需要产出测试或发布版本、选择 Development 与 Shipping、烘焙内容、配置 Packaging 与 Maps & Modes,或用 RunUAT BuildCookRun 做 CI 自动化构建的场景;前提是项目含 .uproject 与 Config/Default.ini,目标是打包后的播放器而非编辑器内运行。商店提交流程不属于本技能,应使用 steam-publish / itch-publish。

主要能力与流程:先在 Project Settings → Maps & Modes → Game Default Map 设置启动地图,这是打包后黑屏最常见的原因。构建配置方面,Development 为默认,保留日志、统计与控制台,便于测试;Shipping 启用全部优化并剥离调试工具,用于发布;DebugGame/Debug 用于调试引擎或游戏代码,不适合分发,且 DebugGame 不支持纯蓝图项目。烘焙(cook)把资源转换为目标平台格式并打包为 .pak,打包(package)把可执行文件与烘焙内容组合为独立可分发文件,打包过程会执行烘焙。编辑器内路径为 Platforms 菜单 → 选择平台(如 Windows)→ 设置 Binary Configuration → Package Project → 选择输出目录。命令行可用 Unreal Automation Tool,例如:RunUAT BuildCookRun -project="C:/Path/MyGame.uproject" -noP4 -platform=Win64 -clientconfig=Shipping -cook -allmaps -build -stage -pak -archive -archivedirectory="C:/Builds/MyGame"。RunUAT 位于 Engine/Build/BatchFiles/(Windows 为 RunUAT.bat,macOS/Linux 为 RunUAT.sh)。去掉 -allmaps 并传 -map=Map1+Map2 可只烘焙部分地图。仅烘焙不打包可加 -cook -skipstage。还可在 Project Settings → Packaging 调整要烘焙的地图/目录、完整重建、压缩等。

限制与注意:打包后应运行可执行文件验证,而非只看烘焙成功。常见问题包括启动地图未设置或未烘焙导致黑屏、误用 Development 发布、引用的地图或资源未烘焙导致运行时缺失、平台 SDK/工具链未安装导致构建失败、UE5 已移除蓝图 Nativization 不能依赖它、首次烘焙因着色器与全部资源从头处理而很慢。相关技能:steam-publish / itch-publish 用于分发,unreal-cpp-gameplay 用于把热点逻辑迁移到 C++。