当前位置：首页 > news >正文

Electron 如何判断运行平台是鸿蒙系统（OpenHarmony）

news 2025/11/10 7:45:44

Electron 如何判断运行平台是鸿蒙系统（OpenHarmony）

随着鸿蒙系统（OpenHarmony）生态的不断发展，越来越多的 Electron 应用开始考虑对其进行适配。而适配的第一步，便是准确判断应用当前运行的平台是否为鸿蒙系统。本文将从核心原理出发，详细介绍两种实用的判断方法，并分享适配过程中的注意事项。

一、核心原理：从系统信息中提取特征

Electron 框架基于 Chromium 和 Node.js，这为我们判断操作系统提供了两个关键途径：

Node.js 层面：通过 Node.js 内置的 os 模块，可以直接获取操作系统的类型、版本等底层信息，鸿蒙系统会在这些信息中留下特定标识。
Chromium 层面：在 Electron 的渲染进程中，可借助浏览器环境的 navigator.userAgent（用户代理）获取系统相关信息，鸿蒙系统的 UA 字符串会包含特征关键字。

通过这两个层面的信息交叉验证，即可实现对鸿蒙系统的准确判断。

二、具体实现：两种判断方法详解

方法 1：主进程中使用 Node.js 的 os 模块

在 Electron 的主进程中，推荐使用 Node.js 内置的 os 模块获取系统信息。鸿蒙系统在 os.type() 和 os.release() 方法的返回值中会体现明显特征：

os.type()：鸿蒙系统会直接返回 'OpenHarmony'；
os.release()：返回的版本信息中会包含 'ohos' 或 'OpenHarmony' 关键字。

基于这些特征，我们可以封装一个通用的判断函数：

const os = require('os');
const { app } = require('electron');/*** 判断当前系统是否为鸿蒙（OpenHarmony）* @returns {boolean} 是鸿蒙返回true，否则false*/
function isHarmonyOS() {try {// 优先通过 os.type() 判断，最直接准确const systemType = os.type();if (systemType === 'OpenHarmony') {return true;}// 兼容部分场景：通过 os.release() 版本特征判断const systemRelease = os.release().toLowerCase();return systemRelease.includes('ohos') || systemRelease.includes('openharmony');} catch (error) {console.error('判断鸿蒙系统失败：', error);return false;}
}// 应用就绪后执行判断
app.whenReady().then(() => {console.log('当前运行平台是否为鸿蒙系统：', isHarmonyOS());
});

方法 2：渲染进程中使用 navigator.userAgent

在 Electron 的渲染进程（如前端页面、Vue/React 组件等）中，无法直接访问 Node.js 的 os 模块，此时可以通过浏览器环境的 navigator.userAgent 进行判断。鸿蒙系统的 UA 字符串格式通常为：Mozilla/5.0 (Linux; U; OpenHarmony 4.0; zh-CN; xxx) AppleWebKit/xxx，其中包含明确的 'OpenHarmony' 关键字。

渲染进程中的判断函数实现如下：

/*** 从 User Agent 中判断是否为鸿蒙系统* @returns {boolean}*/
function isHarmonyOSByUA() {if (!window.navigator) {return false;}const userAgent = window.navigator.userAgent;// 匹配 UA 中的 OpenHarmony 关键字return userAgent.includes('OpenHarmony');
}// 使用示例
document.addEventListener('DOMContentLoaded', () => {const result = isHarmonyOSByUA() ? '当前是鸿蒙系统' : '当前不是鸿蒙系统';document.getElementById('os-result').textContent = result;
});

三、适配注意事项：提高判断准确率与稳定性

在实际项目中，为了确保判断逻辑的可靠性，还需要注意以下几点：

多方法组合判断：单一方法可能存在边缘场景的兼容问题，建议在主进程中结合 os.type() 和 os.release() 判断，在渲染进程中补充 userAgent 验证，通过多维度交叉提高准确率。
处理异常情况：封装判断函数时，需添加 try-catch 逻辑，避免因系统信息获取失败导致应用崩溃（如某些特殊环境下 os 模块方法返回异常值）。
关注版本适配：鸿蒙系统处于快速迭代中，不同版本的 os.release() 或 UA 格式可能略有差异，使用 includes 进行模糊匹配比精确匹配更稳妥。
结合官方适配文档：参考 OpenHarmony SIG Electron 仓库的最新动态，及时同步鸿蒙对 Electron 的适配进展，调整判断逻辑。