同一款游戏要同时上 Steam 和 Epic，两边的 SDK、插件、部分逻辑都不一样。最干净的做法是拆成两个独立的 game project，但移植项目往往没有这个自由度，只能在一份工程里做兼容——这篇记录这套兼容方案怎么落地。

三个拆分点

1. 用宏拆分逻辑代码。 给 Steam / Epic 各自的逻辑加编译宏区分。

一个坑：不要把这个宏定义写在 Game.Build.cs 里，然后又在引擎工程里用它。一旦引擎代码依赖了定义在 game 侧的宏，引擎工程就没法脱离 game 工程单独编译了。宏的定义位置要和使用位置的模块边界对齐。

• https://cloud.tencent.com/developer/article/1368057
• https://www.blurredcode.com/2025/06/3902fd43/
• https://blog.csdn.net/haisong1991/article/details/79832678
• https://zhuanlan.zhihu.com/p/445901502
• https://zhuanlan.zhihu.com/p/445907941
• https://zhuanlan.zhihu.com/p/670789235
• https://dev.epicgames.com/documentation/zh-cn/unreal-engine/using-multi-process-cooking-for-unreal-engine

发布构建之后崩溃 dump 要能还原成可读调用栈,前提是 pdb/符号在出包时就归档进了符号服务器。Windows 侧用的是 symstore.exe(随 Windows SDK / WDK 附带),主机平台各自带一个 CLI,但参数模型几乎一模一样——理解 symstore 就等于理解了它们全部。

symstore.exe(Windows)

随 Windows Kits 附带,路径通常是:

C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\symstore.exe

UE 工程化里绕不开的几块：DDC 缓存、打包命令（BuildCookRun / BuildGraph / UAT）、分布式编译（Horde）、以及多进程 Cook、虚拟资产、Pixel Streaming 这些专项。这一组笔记多数是 UE5.4+ 的实践，配着实测数据和踩坑记录。

DDC 缓存

• DDC 从入门到实战——什么是 DDC、UE5.4 默认的本地 Zen、共享 DDC（传统文件系统方式 + ZenServer Shared）、多项目配置、zen_config.lua 结构，以及一串排错和失败的测试记录。
• IoStore（.utoc/.ucas）——容器格式原理、加载流程、启用/禁用、与 .pak 的对比，外加实验性的 Zen Store 配置。
• Cloud DDC（Jupiter）——架构与部署形态（AWS/本地/Azure）、硬件软件前提，以及 Docker 构建里 SSL 证书链那类排错。

BuildGraph 是 UE 提供的、以 XML 为脚本来自定义版本制作流程的工具。编译、拷贝、压缩这类功能都封装成了标签供脚本调用,搭配分布式构建机和共享存储,可以把整条出包流水线写成一份脚本跑起来。

几个特点:

• XML 语法,语法本身不复杂,难点在 UE 这套标签和属性的语义。
• 面向分布式构建系统设计:多台构建机协作,中间产物通过共享存储位置上传 / 下载。
• 官方文档:How to use BuildGraph、Accelerating your Unreal Engine builds with BuildGraph。

BuildCookRun 是 UAT(Unreal Automation Tool)里最常用的命令,一条命令把 Build / Cook / Stage / Package / Deploy / Run 这几步串起来。编辑器里的 "Package Project"、Project Launcher、UnrealFrontend 打包,底层走的都是它。

跑命令的入口:

Engine\Build\BatchFiles\RunUAT.bat BuildCookRun -Help

Virtual Asset(虚拟资产)把资产的实际负载(payload)从 .uasset 里剥离出来,单独存到 Perforce 等后端,工程里只留引用。好处是减少冗余数据、加快项目加载和运行时效率,让协作流程更灵活。

一个强烈的个人建议:要用就在项目最开始就开。开发中途再回头虚拟化已有资产,会带来一堆不必要的麻烦(后面 Troubleshooting 里几条坑基本都是中途虚拟化踩出来的)。

参考文档:

• https://dev.epicgames.com/documentation/en-us/unreal-engine/overview-of-virtual-assets-in-unreal-engine
• https://dev.epicgames.com/documentation/en-us/unreal-engine/virtual-assets-quickstart-in-unreal-engine
• https://dev.epicgames.com/documentation/en-us/unreal-engine/backend-graphs-for-virtual-assets-in-unreal-engine

这篇记 UE5 的运行时加载器 Zen Loader（也就是 IoStore），以及实验性的 Zen Store。官方文档:Zen Loader、Zen Store。

UAT(Unreal Automation Tool)是 UE 自带的一个 C# 写的工具集合,用来脚本化处理那些"无人值守"的流程:编译代码、Cook 内容、打包游戏、跑 automation test,以及在 build farm 上调度各种操作。源码在 Engine/Source/Programs/AutomationTool——即使你是从 Epic Launcher 装的引擎(没下 GitHub 源码),这部分 UAT 源码也是有的。

官方一句话定义:

AutomationTool is a host program and a set of utility libraries you can use to script unattended processes related to Unreal Engine when using C#.