Skip to main content
UBT 全貌：OpenHarmony 平台构建

一. UBT 的作用与核心价值

Unreal Build Tool (UBT) 是一个定制化的 C# 命令行工具，负责管理虚幻引擎源代码在不同配置和平台下的 C++ 编译过程。

其核心价值在于​将平台差异抽象化。它为上层工具（UAT）提供标准接口，隐藏了底层 SDK、复杂的编译标志以及不同平台工具链（ToolChain）的实现细节。

主要作用包括：

  • 管理 C++ 模块依赖：UBT 解析每个模块的 .build.cs 文件，确定正确的编译顺序和依赖关系。
  • 代码生成：调用 Unreal Header Tool (UHT) ，为虚幻引擎的反射系统生成必要的 C++ 元数据代码。
  • ​调用原生工具链​：抽象化平台差异，调用目标平台的原生编译器（如 MSVC​、Clang）和链接器执行实际的编译工作。
  • ​生成项目文件​：根据源代码动态生成 IDE（如 Visual Studio 的 .sln​ 和 .vcxproj 文件）所需的项目配置。
  • 自动化流程集成：配合 UAT 完成从代码编译到最终打包的自动化流程。
UBT · UEBuildPlatform（平台构建核心）

在 UBT 构建平台配置中，通常要实现五个功能模块，​UEBuildPlatform​​是其中的核心。

模块类名 定位 核心职责
​UnrealTargetPlatform 平台唯一标识符 使用 partial struct 模拟类型安全的枚举，提供全局唯一的平台 ID。
​TargetRules 编译参数配置 存在于项目的 .Target.cs 文件中， 定义构建游戏客户端、服务器或编辑器所需的高级设置。
​UnrealArchitectureConfig 平台架构配置 确定当前平台构建时支持哪些CPU架构。
​UEBuildPlatform 平台构建逻辑 负责管理 SDK 检测、工具链路径和架构支持等支持。
​UEBuildPlatformFactory 动态加载与注册 负责在 UBT 启动时实例化对应的 UEBuildPlatform 类并进行注册。
UBT · PlatformSDK

一. PlatformSDK 的定位与用途

当我们需要为某个平台实现它的PlatformSDK时，我们需要先了解UEBuildPlatformSDK。

​UEBuildPlatformSDK 在 Unreal Build Tool (UBT) 架构中充当平台开发工具包（SDK）配置管理器的角色。它的核心功能是管理特定平台的 SDK、NDK 和工具链的安装路径、版本信息以及环境配置。它负责定位系统上的开发工具。

该模块的主要用途包括：

  • SDK/NDK 检测：
    核心职责是定位 SDK/NDK 的根目录，并验证其存在性和有效性。
  • 版本检测：
    检查并返回 SDK/NDK 的版本号，确保符合构建要求。
  • 环境自检：
    提供接口来快速判断是否有可用的 SDK 配置，确保构建的前提条件已满足。
UBT · PlatformToolChain

一：PlatformToolChain 在 UBT 中的角色与定位

​PlatformToolChain 是 UBT 架构的核心组件，负责管理特定目标平台的底层编译器、链接器以及其他构建工具的交互。

它的主要职责是衔接（或对接）通用的 C++ 模块定义（由 .Build.cs 和 .Target.cs 描述）与特定硬件架构和操作系统所需的实际编译器命令之间的逻辑。

简单来说，UBT 决定构建什么，而 PlatformToolChain 决定如何使用正确的工具去构建。

UBT · PlatformProjectGenerator

一. UBT PlatformProjectGenerator 的定位与用途

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

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

UBT · PlatformExports

一. PlatformExports.cs 的定位与用途

在 Unreal Engine 的构建系统中，PlatformExports.cs（如 AndroidExports.cs、IOSExports.cs）文件的核心定位是充当一个通用接口层（Public Interface Layer），连接平台无关的自动化工具（UAT）和平台特定的构建实现逻辑（UBT Modules、SDK Tools）。

它们的主要用途包括：

UBT · UnrealArchitectureConfig

一、UBT 中的构建架构管理

​UnrealArch：

​UnrealArch 是一个枚举类型（Enum-like Class）， 代表构建平台的一个特定硬件 CPU 架构（例如 Arm64、x64）。

  • 用途： 此标识符直接指导底层的编译器和链接器生成特定 CPU 指令集的机器码。每个平台相关的自动化脚本（如 AndroidPlatform.Automation.cs）会将其内部识别的架构字符串映射到这个标准类型。
  • 注意： 当 UBT 需要执行需要明确单一目标架构的特定步骤（例如链接阶段），且配置了多个架构时，可能会要求明确指定一个架构。