uni-app + DevEco 鸿蒙跨平台应用开发实战1-环境安装分享

这篇是专门针对 Mac M2 芯片设备整理的环境安装指南，全程适配 ARM 架构。主要记录用 uni-app（依托 HBuilderX）和 DevEco Studio 开发鸿蒙应用时，第一步 “环境搭建” 的完整流程 —— 从工具下载到模拟器配置，每个步骤都会说清操作细节，新手跟着走基本能避坑。

一、基础准备（精简版）

1.1 系统版本要求

Mac 需为 macOS 12 及以上 64 位版本，建议更新至最新系统补丁，保障 ARM 架构工具兼容性。

1.2 JDK 配置：最新版 IDE 无需手动安装（实测结论）

实测发现，DevEco Studio 6.0.0 及以上版本已自带适配 M2 芯片的 ARM 架构 OpenJDK 11，完全不用手动下载安装，手动安装反而可能触发依赖冲突。具体注意点：

（1）默认用内置 JDK（推荐）

1. 安装后内置 JDK 路径：/Applications/DevEco Studio.app/Contents/jbr；

2. 启动 IDE 会自动加载，确认生效可打开 DevEco，进入 File > Settings > Build, Execution, Deployment > Build Tools > Gradle，查看 “Gradle JVM” 显示 “Embedded JDK (11.0.x, aarch64)” 即正常。

（2）仅特殊场景需手动干预

• 启动 IDE 提示 “JVM 初始化失败”“架构不匹配”（可能内置 JDK 文件损坏）；

• 使用 HBuilderX 4.60 以下版本，联动编译时报错 “找不到 JAVA_HOME”；

• 自定义流水线编译（非 IDE 内编译），需配置系统级 JAVA_HOME。

二、装 DevEco Studio（鸿蒙开发核心工具）

选 DevEco Studio 一定要挑 ARM 架构的版本！之前误下了 Intel 版，装完一点就闪退，白忙活半天。目前华为已发布 6.0.1 正式版，推荐优先安装此版本。

2.1 下载 ARM 版的 DevEco（官方双渠道）

1. 官方渠道一（产品页）：华为开发者官网 DevEco 产品页；

2. 官方渠道二（下载中心）：华为消费者业务下载中心（搜索 “DevEco Studio” 即可找到对应资源）；

3. 点 “Mac（ARM）” 选项下载（页面会标 “适用于 M1/M2 芯片”），版本要和后续的 HBuilderX 匹配，不然可能不兼容：

• 装 HBuilderX 4.85 及以上版本（推荐）：优先选 DevEco Studio 6.0.0+（正式版），支持 uni-app x 热重载优化；

• 装 HBuilderX 4.61-4.84 版本：可选 DevEco Studio 5.1.1+（Beta 版）或 6.0.0+（兼容适配）；

• 装 HBuilderX 4.60 以下版本：需用 DevEco Studio 5.0.7.100+（旧稳定版），可在下载页历史版本区获取；

1. 勾上 “同意用户协议”，等着下载完成就行（文件是 .dmg 格式）。

2.2 安装 DevEco

1. 双击下好的 .dmg 文件，把 “DevEco Studio” 拖到 “应用程序” 文件夹；

2. 第一次启动要注意：

• 右键点 “应用程序” 里的 “DevEco Studio”，选 “打开”（macOS 默认会拦陌生开发者的软件）；

• 弹出 “安全性与隐私” 提示时，点 “系统设置”，在 “通用” 页点 “仍要打开”，完成信任配置，不然启动不了。

2.3 第一次启动的配置

1. 第一次打开会问是否导入配置，选 “Do not import settings”（新装的没旧配置），点 “OK”；

2. 进入 “SDK Setup” 界面：

• “OpenHarmony SDK” 必须勾上（这是鸿蒙跨平台的核心依赖），“HarmonyOS SDK” 可选（装了能兼容旧版应用）；

• SDK 路径建议设成 /Applications/DevEco Studio.app/Contents/SDK，6.0 版本优化了权限管理，但自定义路径仍可能出现访问问题，默认路径更稳；

• 点 “Next”，系统会自动下 ARM 架构的 SDK 包（6.0 版本 SDK 约 20GB，耗时 15-30 分钟，看网速快慢）；

1. SDK 下完点 “Finish”，就能进 DevEco 的主界面了。

三、装 uni-app 的开发工具 HBuilderX

HBuilderX 是绿色版，直接下 Mac 版就行，建议选新版本 —— 最近鸿蒙开发的功能更新得勤，旧版本可能缺热重载、调试这些实用功能。

3.1 下载 HBuilderX（版本选择很重要）

先整理下版本对应的功能，方便选：

版本类型	推荐版本号	近期更新的鸿蒙功能（实用的）
稳定版	4.85	支持 uni-app x 项目热重载（改完代码不用重新编译）、ARM 模拟器调试、配置自动同步
Alpha 版（预览）	4.86	能提前体验鸿蒙 PC 设备适配（可以模拟 PC 端）、证书指纹自动识别这些新功能

具体下载步骤：

1. 去 HBuilderX 官网下载页；

2. 选版本：

• 想要稳定就点 “标准版（Mac）” 下载（文件是 .dmg，标准版可安装相关插件）；

• 想尝鲜新功能就拉到页面下方 “历史版本”，点 “Alpha 版（Mac）” 下载，不过得登录 DCloud 账号；

1. 安装简单：双击 .dmg 文件，把 “HBuilderX” 拖到 “应用程序” 文件夹，不用额外配置，会自动适配 M2 的 ARM 架构。

3.2 装 uni-app 的鸿蒙适配插件

1. 打开 “应用程序” 里的 “HBuilderX”，第一次启动也要通过 “安全性与隐私” 信任；

2. 点顶部菜单栏的 “工具> 插件安装”；

3. 在 “插件市场” 搜 “uni-app 鸿蒙”，找到 “uni-app 鸿蒙平台支持插件”，点 “安装”；

4. 装完一定要重启 HBuilderX！之前没重启，插件没生效，还以为是安装失败了。

四、把 uni-app 和 DevEco 连起来（关键一步）

得让 HBuilderX 识别 DevEco 的 ARM 版工具，不然编译时找不到 SDK 和 ohpm，项目跑不起来。

4.1 配置 DevEco 和 SDK 的路径

1. 打开 HBuilderX，点 “工具> 选项 > 运行配置 > 鸿蒙配置”；

2. 填路径（参考默认路径，不容易错）：

• “DevEco Studio 安装路径”：直接选 “应用程序” 里的 “DevEco Studio.app”；

• “OpenHarmony SDK 路径”：填 /Applications/DevEco Studio.app/Contents/SDK，要和 DevEco 里的 SDK 路径一致，而且得是 ARM 版的；

1. 点 “验证路径”，提示 “路径验证成功” 就继续；要是失败，看看路径里有没有中文或者空格，这些字符容易导致识别出错。

4.2 配置 ohpm 工具路径

1. “ohpm 路径” 一般会自动填成 /Applications/DevEco Studio.app/Contents/SDK/ohpm/bin/ohpm（这是 ARM 版 ohpm 的路径）；

2. 要是没自动填，就手动把上面的路径粘进去，点 “验证”—— 注意得指向可执行文件，别指到文件夹，之前误指到文件夹就验证失败了。

五、装鸿蒙模拟器（调试必备）

M2 芯片只能用 aarch64 架构的模拟器，其他架构用不了，这步得按流程来，不然启动不了。

5.1 打开模拟器管理

1. 打开 DevEco Studio，点顶部工具栏的 “Tools> Device Manager”（或者按快捷键 Cmd+Shift+M，更快）；

2. 点 “New Device”，新建一个模拟器。

5.2 配置模拟器参数

1. 选设备类型：新手建议先选 “Phone”（手机），想试 PC 端就选 “PC”（不过得 HBuilderX 4.71 以上才支持）；

2. 选系统版本：建议选 “HarmonyOS 6.0.1 (21) Release”，这是最新稳定版 ARM 镜像，支持 API 20，适配所有 uni-app/uni-app x 项目；

3. 选镜像架构：这步很关键！必须勾 “aarch64”（要是显示 “x86_64”，说明之前 SDK 下错了，得回第二步重新下 ARM 版 SDK）；

4. 点 “Next”，给模拟器起个名（比如 “OH-Phone-6.0”），点 “Finish”，等它初始化镜像，大概 2-3 分钟。

5.3 启动模拟器

1. 在 “Device Manager” 列表里，找到刚建的 aarch64 架构模拟器，点 “Launch” 启动；

2. 第一次启动会慢一点，大概 3-5 分钟，后面再开就快了，1 分钟左右；启动后状态栏会显示 “aarch64”，说明没问题。

六、验证环境能不能用（最后一步）

装完得试一下，确保能跑起来才算完成。

6.1 建一个 uni-app 鸿蒙项目

1. 打开 HBuilderX，点 “文件> 新建 > 项目”；

2. 选项目类型：

• 想稳一点就选 “uni-app”，勾上 “鸿蒙” 平台；

• 想体验更好的性能，就选 “uni-app x”（得 HBuilderX 4.61 以上），这个默认支持鸿蒙；

1. 给项目起个名（比如 “OH-Uni-Demo”），选 “默认模板”，点 “创建”—— 路径建议放 ~/Documents/HBuilderXProjects/，别用中文，之前用中文路径出过错。

6.2 编译运行到模拟器

1. 先确保 aarch64 模拟器已经启动；

2. 在 HBuilderX 里，点顶部的 “运行” 按钮，选 “运行到手机或模拟器 > 鸿蒙模拟器 > OH-Phone-6.0”（选刚才起的模拟器名）；

3. 等编译完成：第一次大概 3-4 分钟，HBuilderX 4.85 + 配合 DevEco 6.0.0 + 支持热重载，后续改代码仅需 5-10 秒；

4. 要是模拟器里显示 “Hello uni-app” 的页面，而且控制台没报错，就说明环境装对了！

总结下实战重点

1. 基础准备简化：Mac 系统需 macOS 12+，DevEco 6.0.0 + 自带 ARM 版 OpenJDK，无需手动装；

2. 版本适配是核心：优先选 DevEco 6.0.1 + 搭配 HBuilderX 4.85+，旧版本需对应适配；

3. 官方渠道双保障：从华为开发者官网或消费者下载中心获取工具，务必选 ARM 架构；

4. 架构别搞错：DevEco、SDK、模拟器都得是 ARM/aarch64 版本，不然兼容性出问题；

5. 路径别乱设：安装路径不用中文和空格，默认 /Applications/ 下更稳；

6. 首次启动要信任：DevEco 和 HBuilderX 第一次打开，需在 macOS “安全性与隐私” 中授权。

环境装完，接下来就能做页面开发了，比如写 uvue 组件、写 uts 逻辑。要是想连真机调试，可以后面再配置 —— 先确保模拟器能跑通，再推进下一步会更稳。