UBT · PlatformProjectGenerator

一. UBT PlatformProjectGenerator 的定位与用途

​PlatformProjectGenerator 在 Unreal Engine 构建系统中的定位是连接 UBT 内部数据模型与外部集成开发环境（IDE）或构建系统的桥梁。

其核心作用是：在运行 GenerateProjectFiles 命令时，根据不同平台的需求，定制化生成的项目文件（如 .vcxproj、Makefile、.xcfilelist 等），确保开发者能在目标开发环境中正确地配置、编译和调试特定平台的代码。

主要用途：

• IDE 集成与配置：
  允许 UBT 通知 Visual Studio、Xcode 或其他支持的 IDE 如何处理特定平台的配置（例如，定义一个名为 OpenHarmony 的配置）。
• ABI 映射：
  提供 Unreal Engine 内部使用的通用架构标识（UnrealArch）与平台原生 ABI 字符串（如 arm64-v8a）之间的双向映射。
• 路径与工具链指定：
  为 IDE 提供指向正确 SDK、NDK 或编译工具链的路径，确保 IDE 能够找到正确的编译器和调试器。

---

二. 添加新平台支持时需要关注的信息

当你需要为新平台（如 OpenHarmony）实现一个新的 PlatformProjectGenerator 扩展时，需要实现部分Override 函数，比如：

Override 函数	用途	补充
​GetPlatforms()	返回生成器对应的平台枚举 （如：UnrealTargetPlatform.Android）。	将 Generator 和 Platform 绑定起来。 用于UBT 的 PlatformProjectGenerators 处理流程。
​GetVisualStudioPlatformName()	返回 VS 解决方案中显示的平台名称 （比如NS2 -> "Ounce64"）。	将UBT内部使用的平台转换为 VS 中实际使用的、规范的平台名称。
​GetShortAbi() GetLongAbi()	返回 UnrealArch 对应的当前平台 ABI 标识。	确保构建脚本能够将正确的 ABI 标识符传递给 NDK 或其他原生工具链。
​GetVisualStudioPathEntries()	为 VS 项目文件添加 添加当前 平台构建和调试所需的特定路径配置。	比如提供SDK的访问路径信息 比如提供调试符号的目录信息

---

三. 需要警惕的内容和风险

在实现 PlatformProjectGenerator 时，需要特别注意以下几点，以避免构建系统出现问题：

• IDE 兼容性假设 (IDE Compatibility Assumptions)：
  警惕假设你的目标平台只能在唯一的 IDE 上编译。Unreal Engine 的哲学是尽可能实现平台无关的主机构建。即使主要 IDE 是 DevEco Studio，你也需要确保在 Windows 上使用 Visual Studio 生成的项目文件至少可以触发正确的后台构建命令（例如调用 Gradle 或其他自定义脚本）。
• ABI 字符串不匹配 (ABI String Mismatches)：
  ​GetShortAbi 和 GetLongAbi 返回的字符串必须与平台原生工具链（NDK 等）期望的精确 ABI 名称完全一致，否则会导致编译错误或链接器找不到正确的原生库。
• 遗漏配置类型 (Missing Configuration Types)：
  确保为所有标准的 UE 构建配置（Development、Shipping、Debug 等）都生成了正确的 IDE 配置项。遗漏任何一个都会导致在尝试构建特定版本时出现配置查找错误。

‍