本手册旨在系统地指导如何在UE5.6中添加 OpenHarmony 平台的支持。整个流程遵循Epic Games推荐的平台扩展架构，并特别针对OpenHarmony的Hvigor构建系统和原生ArkNative API进行定制。

阶段一：环境准备与架构搭建

此阶段旨在建立必要的基础开发环境和源代码管理。

1.1 获取UE5.6的源码

从内部引擎源码仓库中获取UE5.6的源码：

P4 Server: <your-perforce-server>:1666

一. 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 完成从代码编译到最终打包的自动化流程。