使用 Electron 定制自己的鸿蒙PC应用

使用 Electron 定制自己的鸿蒙应用

本文介绍如何基于 Electron 项目定制鸿蒙版应用，包括应用名称、图标、资源替换等配置方法。

一、替换应用名称

应用名称配置文件位置：

ohos_hap\electron\src\main\resources\zh_CN\element\string.json

操作步骤：

1. 打开上述路径中的 string.json 文件
2. 找到 EntryAbility_label 字段
3. 修改该字段的值为您的应用名称

示例：

{
  "string": [
    {
      "name": "EntryAbility_label",
      "value": "您的应用名称"
    }
  ]
}

二、替换应用图标

应用图标资源位置：

ohos_hap\AppScope\resources\base\media

操作步骤：

1. 准备符合鸿蒙规范的应用图标文件
2. 将图标文件替换到上述 media 目录中
3. 确保图标文件名与配置文件中引用的名称一致

注意事项：

• 建议提供多种尺寸的图标以适配不同设备
• 图标格式推荐使用 PNG 格式
• 遵循鸿蒙应用图标设计规范

三、资源替换与编译

3.1 编译产物处理

由于鸿蒙目前暂无完整的 Electron 编译环境，如果项目使用 TypeScript 等需要编译的语言，需要按以下步骤处理：

操作步骤：

1. 在本地或其他环境完成代码编译（如 TypeScript 编译为 JavaScript）
2. 将编译后的 JS 文件复制到以下目录：

web_engine/src/main/resources/resfile/resources/app

1. 确保所有依赖文件都已正确放置

3.2 三方库兼容性问题

在使用开源 npm 库时，可能会遇到以下兼容性问题：

问题 1：原生插件（Addon）适配

• 问题描述：npm 库中使用了 C++ 编写的 Addon（原生模块），未适配鸿蒙平台
• 影响：无法在鸿蒙系统上正常加载和使用
• 解决方案：参考 sqlite3 等库的适配方案，重新编译适配鸿蒙平台

问题 2：平台检测 API 兼容性

• 问题描述：npm 库使用 process.platform、os.type() 等 API 判断平台类型
• 原因：鸿蒙系统返回 ohos，而大多数三方库不识别此平台标识
• 影响：可能导致功能异常或无法运行
• 解决方案：
  • 修改三方库源码，添加对 ohos 平台的支持
  • 或在应用层做兼容性处理，将 ohos 映射为库能识别的平台

问题 3：二进制文件依赖

• 问题描述：npm 库包含预编译的二进制文件（如 esbuild、node-sass 等）
• 影响：二进制文件未针对鸿蒙平台编译，无法执行
• 解决方案：
  • Linux 环境：需要 root 权限重新编译
  • 新版鸿蒙 PC：采用 HNP（HarmonyOS Native Package）方案

四、多实例配置

鸿蒙应用支持多实例模式，即同一应用可以同时运行多个独立实例。

配置说明：

• 启用多实例：在配置文件中添加 "multiAppMode" 配置
• 禁用多实例：如果应用不需要多实例功能，请将 "multiAppMode" 配置项删除

配置文件位置：

ohos_hap/entry/src/main/module.json5

示例：

{
  "module": {
    // 其他配置...
    "multiAppMode": {
      "multiAppModeType": "multiInstance"
    }
  }
}

五、常见问题与注意事项

1. 路径分隔符：在不同操作系统中，请使用正确的路径分隔符（Windows 使用 \，macOS/Linux 使用 /）
2. 文件编码：确保配置文件使用 UTF-8 编码，避免中文乱码
3. 权限配置：如果应用需要特殊权限，请在 module.json5 中正确声明
4. 测试验证：每次修改后建议在真机或模拟器上进行完整测试

六、参考资料

• 鸿蒙应用开发官方文档[1]
• Electron 文档[2]
• 更多定制化配置请参考项目内的配置文件说明。
• 作者：坚果

参考资料

[1]

鸿蒙应用开发官方文档: https://developer.harmonyos.com/

[2]

Electron 文档: https://www.electronjs.org/