一、環境準備

1. 基礎環境要求

• 操作系統：Windows 10/11 或 macOS (建議版本最新)
• Node.js: v16.x 或更高版本
• npm: v8.x 或更高版本
• Java JDK: 11 或更高版本
• DevEco Studio: 3.1 或更高版本 (鴻蒙官方IDE)

2. 安裝 DevEco Studio

1. 從華為開發者官網下載
2. 安裝時選擇以下組件：
   • HarmonyOS SDK
   • JS SDK
   • Toolchains

3. 配置環境變量

# 在 ~/.bashrc 或 ~/.zshrc 中添加
export HARMONY_HOME=/path/to/harmony/sdk
export PATH=$PATH:$HARMONY_HOME/toolchains

二、項目創建與配置

1. 創建 React Native 項目

npx react-native init MyHarmonyApp --template react-native-template-harmony

2. 項目結構調整

MyHarmonyApp/
├── android/          # 保留但不需要
├── ios/              # 保留但不需要
├── harmony/          # 鴻蒙平臺代碼
│   ├── entry/
│   ├── build.gradle
├── src/              # 共享業務代碼
├── package.json

3. 安裝必要依賴

npm install @react-native-harmony/cores @react-native-harmony/hm-components

三、鴻蒙平臺適配

1. 配置 entry/src/main/js/default/pages/index.ets

import { createElement } from '@react-native-harmony/cores'
import App from '../../../src/App'@Entry
@Component
struct Index {build() {createElement(App)}
}

2.