配置 HarmonyOS 5 与 React Native 的开发环境需遵循以下步骤

一、基础工具安装

1. ‌DevEco Studio 5.0+‌

   • 从 HarmonyOS 开发者官网 下载安装
   • 勾选组件：
     • HarmonyOS SDK (API 12+)
     • ArkTS 编译器
     • JS/ArkTS 调试工具
     • HarmonyOS 本地模拟器 

2. ‌Node.js 18.17+

   # 安装后验证版本
   node -v
   npm -v
   

3. 需支持 ES2020+ 语法特性 

npx react-native@0.72.5 init MyApp --template react-native-template-harmonyos

必须 ≥0.72.5 以避免线程冲突

二、环境变量配置

macOS/Linux

# 编辑 ~/.bashrc 或 ~/.zshrc
export PATH="/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains:$PATH"
export HDC_SERVER_PORT=7035  # 设置hdc调试端口
export CAPI_INCLUDE_PATH="$HARMONY_HOME/napi_sdk"

执行 source ~/.bashrc 生效 

Windows

1. 系统环境变量 Path 添加：
   {DevEco安装路径}\sdk\default\openharmony\toolchains
2. 新建系统变量：
   • HDC_SERVER_PORT=7035
   • CAPI_INCLUDE_PATH={DevEco安装路径}\napi_sdk 

---

三、鸿蒙专属模块集成

1. ‌安装鸿蒙桥接库

npm install @ohos/react-native-harmony --save

‌2. 链接原生模块

npx react-native link @ohos/react-native-harmony
``` :ml-citation{ref="2,5" data="citationList"}  

四、权限声明配置

在 entry/src/main/ets/ohos/Ability.json 添加分布式权限：

"requestPermissions": [{"name": "ohos.permission.DISTRIBUTED_DATASYNC"}
]

五、JS引擎优化

在 oh-package.json 添加内存限制：

"jsEngine": {"type": "harmony-jsengine","config": { "memoryLimitMB": 512 }
}

防止多线程死锁

六、环境验证

# 检查hdc连接
hdc list targets# 启动RN开发服务
npx react-native start# 编译并运行到设备
npx react-native run-harmonyos

成功运行后设备显示鸿蒙欢迎界面

常见问题解决

错误类型	解决方案
hdc command not found	检查环境变量PATH是否包含toolchains路径
JS线程死锁	确保jsEngine内存限制为512MB
分布式权限缺失	在ability.json声明DISTRIBUTED_DATASYNC
模板初始化失败	强制指定RN版本：@0.72.5