开源鸿蒙跨平台开发入门：ReactNative开发HarmonyOS环境搭建全攻略 (Day01)

1. 环境准备

在开始之前，请确保你的电脑满足以下最低配置：

• 操作系统：Windows 10/11（64位）、macOS 12+ 或 Ubuntu 20.04+
• 内存：至少8GB（推荐16GB）
• 磁盘空间：至少20GB可用空间

需要安装的工具清单：

• Node.js 18+ 和 npm/yarn
• JDK 11（或更高版本）
• DevEco Studio（鸿蒙官方IDE，内含HarmonyOS SDK）
• Git（可选，用于版本控制）

2. 安装Node.js

访问Node.js官网，下载LTS版本（例如18.x或20.x）。双击安装包，一路“下一步”即可。安装完成后，打开终端（命令提示符），输入以下命令验证：

node -vnpm -v

如果显示版本号，说明安装成功。

3. 安装JDK

HarmonyOS开发需要JDK 11及以上版本。推荐使用开源鸿蒙官方推荐的JDK（如华为JDK或OpenJDK）。你可以从Adoptium下载OpenJDK 11。安装后设置JAVA_HOME环境变量，并将%JAVA_HOME%�in添加到Path。验证：

java -version

4. 安装DevEco Studio并配置HarmonyOS SDK

访问华为开发者联盟，下载DevEco Studio。安装后启动，首次启动会引导安装HarmonyOS SDK。建议选择API 9或更高版本，并勾选“SDK Platforms”和“SDK Tools”中的必要组件。等待下载完成。

5. 创建React Native项目

使用ReactNative脚手架创建新项目。打开终端，执行：

npx react-native@latest init MyHarmonyApp

进入项目目录：

cd MyHarmonyApp

6. 集成react-native-harmony

为了让ReactNative支持HarmonyOS，我们需要安装react-native-harmony包。在项目根目录执行：

npm install react-native-harmony

安装完成后，需要初始化鸿蒙工程：

npx rn-harmony-init

该命令会在项目下生成harmony目录，包含鸿蒙工程文件。

7. 在DevEco Studio中打开鸿蒙工程并运行

启动DevEco Studio，选择“Open Project”，定位到项目中的harmony目录。等待项目加载完成。连接鸿蒙设备（真机或模拟器），点击运行按钮（绿色三角）。首次运行可能会下载依赖，请保持网络畅通。如果一切顺利，你将在设备上看到React Native的欢迎界面！

8. 常见问题

• 问题：编译时提示SDK版本不匹配。解决：检查build.gradle中的compileSdkVersion和targetSdkVersion，确保与已安装的HarmonyOS SDK版本一致。
• 问题：模拟器无法启动。解决：检查HAXM是否安装，或尝试使用真机调试。
• 问题：Node.js版本过低。解决：使用nvm或直接升级到18+。

9. 结语

至此，你已经成功搭建了开源鸿蒙下的ReactNative开发环境，迈出了跨平台开发的第一步。后续我们将深入学习组件使用、原生模块调用等高级主题，敬请期待！

—— Day01 环境搭建篇 完 ——