配置 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