在 UE5.6 中支持 OpenHarmony 新平台

本系列记录为 Unreal Engine 5.6 新增 OpenHarmony（鸿蒙）平台支持的完整工程实践：从平台扩展的整体架构，到 UBT（UnrealBuildTool）各扩展点的实现、UEDeployPlatform 打包、UAT 自动化层，再到 HarmonyOS 宿主应用搭建与 Native C++ 工具链。整体遵循 Epic 推荐的平台扩展范式，针对 OpenHarmony 的 Hvigor 构建系统和 ArkNative API 做定制。

这是社区较稀缺的 UE 新平台移植一手资料，含大量可复用的 UBT/UAT 扩展代码与踩坑记录。

目录

总览

• 全局指导手册 — 平台支持的整体流程、环境准备与目录结构
• UBT 全貌 — UnrealBuildTool 平台扩展的各组成部分与调用关系

UBT 各扩展点

• UEBuildPlatform（平台构建核心） — 平台编译配置的核心类，含完整实现
• PlatformSDK — SDK 版本管理与探测
• PlatformToolChain — 编译/链接工具链封装
• PlatformProjectGenerator — IDE 工程文件生成
• PlatformExports — 平台能力导出接口
• UnrealArchitectureConfig — 架构（arch）配置

打包与自动化

• UEDeployPlatform（打包部署） — 打包流程，含与 Android 的对比
• UAT 层扩展 — AutomationTool 层的命令行驱动与 CI 集成

HarmonyOS 宿主与工具链

• HarmonyOS 宿主应用搭建 — DevEco 工程、签名流程与宿主壳应用
• HarmonyOS Native C++ 工具链与 Sanitizers — 鸿蒙原生 C++ 工具链速览与 Sanitizers