一、环境准备

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.