一、环境准备
1. 基础环境要求
- 操作系统:Windows 10/11 或 macOS (建议版本最新)
- Node.js: v16.x 或更高版本
- npm: v8.x 或更高版本
- Java JDK: 11 或更高版本
- DevEco Studio: 3.1 或更高版本 (鸿蒙官方IDE)
2. 安装 DevEco Studio
- 从华为开发者官网下载
- 安装时选择以下组件:
- HarmonyOS SDK
- JS SDK
- Toolchains
3. 配置环境变量
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.