如何在鸿蒙上运行 Electron

5 分钟，从零跑起一个 Electron 应用在鸿蒙 PC 上。

---

前置条件

项目	要求
DevEco Studio	已安装
鸿蒙 PC	一台真机（用于调试运行）
数据线	USB-C 连接鸿蒙电脑
华为开发者账号	用于下载 Electron 包和配置签名

⚠️ 关于模拟器：鸿蒙Electron模拟器目前仅支持 ARM 架构的 Mac 电脑，Windows 用户请使用真机调试。

---

Step 1：下载鸿蒙版 Electron

访问华为官方 CodeHub 仓库，下载对应版本的 Electron：

🔗 Electron34 Release - CodeHub

目前鸿蒙支持三个版本：

Electron	Chromium	Node.js
25	114	18.18.2
34	132	20.18.1
37	138	22.16.0

💡 不确定选哪个？先用 Electron 34，稳定性与兼容性兼顾。

---

Step 2：解压压缩包

下载完成后解压，你会看到类似这样的目录结构：

v34.8.1-20260429.1-release/
└── libelectron_132/
    └── libelectron/
        └── ohos_hap/        ← 等会儿要用的就是这个文件夹

---

Step 3：用 DevEco Studio 打开工程

1. 打开 DevEco Studio
2. 选择 文件 → 打开项目
3. 选择目录中的 ohos_hap 文件夹：

v34.8.1-20260429.1-release/libelectron_132/libelectron/ohos_hap

4. 点击 OK，等待工程加载完成

---

Step 4：连接鸿蒙电脑

1. 用 数据线连接鸿蒙电脑
2. DevEco Studio 右上角应能识别到你的设备

---

Step 5：配置签名

在 DevEco Studio 中：

1. 进入 文件 → 项目结构 → 签名配置
2. 登录华为开发者账号
3. 自动生成签名证书（或手动导入已有证书）
4. 确认签名配置无误

签名是鸿蒙应用运行的必要条件，未签名的应用无法安装到设备上。

---

Step 6：运行

1. 点击 DevEco Studio 工具栏的 ▶ Run 按钮
2. 等待编译完成并推送到鸿蒙电脑
3. 鸿蒙电脑上会自动启动一个 Electron 窗口，默认打开 Bing 搜索页面

🎉 恭喜！你的第一个 Electron 应用已经在鸿蒙上跑起来了。

---

常见问题

Q：Windows 电脑能用模拟器吗？

不能。鸿蒙模拟器需要 ARM 架构，只有 Mac（Apple Silicon） 支持。Windows 用户请使用鸿蒙真机。

Q：能打开自己的网页吗？

可以 工程中找到 ohos_hap\web_engine\src\main\resources\resfile\resources\app
目录下的文件替换为你自己的页面即可。

Q：已有Electron项目，如何适配HarmonyOS PC？

参考已有Electron项目，如何适配HarmonyOS PC