| 步骤 | 详细说明 | 关键配置与要求 |
|---|---|---|
| 安装 DevEco Studio | 下载并安装最新版官方 IDE。 DevEco Studio提供开箱即用的开发体验，将HarmonyOS SDK、Node.js、Hvigor、OHPM、模拟器平台等进行合一打包，简化DevEco Studio安装配置流程。 |
建议使用最新稳定版 DevEco Studio。 |
| SDK | HarmonyOS SDK已嵌入DevEco Studio中，无需额外下载配置。 HarmonyOS SDK可以在DevEco Studio安装位置下DevEco Studio\sdk目录中查看。如需进行OpenHarmony应用开发，可通过File > Settings > OpenHarmony SDK页签下载OpenHarmony SDK。 |
|
| 开发者账号 | 注册华为开发者账号，完成实名认证（企业或个人）。 | 必须实名认证才能申请正式证书。 |
Clang Sanitizer 是一组用于在 C/C++ 代码编译时启用运行时错误检测的工具集。通过在生成的二进制代码中插入特定的检测代码（代码插桩），并在运行时链接到相应的库，这些工具可以帮助开发者在开发和测试阶段识别内存错误和未定义行为，提升代码质量。
| 枚举值 | 工具名称 | 功能描述与用途 |
|---|---|---|
| None | 无 | 默认设置，不启用任何 Sanitizer，无性能开销。 |
| Address | ASan (Address Sanitizer) | 内存错误检测：检测缓冲区溢出、释放后使用、重复释放等问题。自 2023 年起，Android 平台已不推荐使用 ASan，而是推荐使用 HWASan。 |
| HwAddress | HWASan (Hardware-assisted Address Sanitizer) | 硬件辅助内存错误检测：利用 ARM64 的内存标记等硬件特性，以更低的 RAM 开销检测内存错误。是 Android 10 及更高版本以及 HarmonyOS 开发的首选工具。 |
| UndefinedBehavior | UBSan (Undefined Behavior Sanitizer) | 未定义行为检测：检测空指针解引用、整数溢出、数组越界、无效位移操作等 C/C++ 中的未定义行为。 |
| UndefinedBehaviorMinimal | UBSan (Minimal) | UBSan 的子集，仅启用部分未定义行为检查，以减少性能开销。 |
| Thread | TSan (Thread Sanitizer) | 线程错误检测：检测多线程程序中的数据竞争（data races）和其他线程错误。 |
本系列记录为 Unreal Engine 5.6 新增 OpenHarmony（鸿蒙）平台支持的完整工程实践：从平台扩展的整体架构，到 UBT（UnrealBuildTool）各扩展点的实现、UEDeployPlatform 打包、UAT 自动化层，再到 HarmonyOS 宿主应用搭建与 Native C++ 工具链。整体遵循 Epic 推荐的平台扩展范式，针对 OpenHarmony 的 Hvigor 构建系统和 ArkNative API 做定制。
这是社区较稀缺的 UE 新平台移植一手资料，含大量可复用的 UBT/UAT 扩展代码与踩坑记录。