这些能力全部在主进程使用,渲染进程通过 IPC 请求。
平台差异:
role 让 Electron 使用系统标准行为与本地化文案,优先使用 role 而不是自己实现。注意事项:
Template 结尾),系统会自动反色。Tray 必须在 app.whenReady() 之后创建。差异:
| 平台 | 注意点 |
|---|---|
| Windows | 必须设置 AppUserModelId,且应用需要正确安装(开始菜单快捷方式) |
| macOS | 首次通知会请求权限,用户拒绝后需引导到系统设置 |
| Linux | 依赖桌面环境的通知服务,部分环境不支持点击回调 |
原则:
Command+Space、Alt+Tab)。保存对话框:
原则:
自定义协议用于「从浏览器或其他应用唤起本应用」,例如 myapp://project/123。
注意事项:
process.defaultApp)需要把可执行文件与入口脚本一起注册,否则协议指向 Electron 本身。Info.plist 中配置 CFBundleURLTypes,打包工具通常会自动生成。如果只是让页面加载本地资源,使用 protocol.handle:
平台差异:
| 平台 | 行为 |
|---|---|
| macOS | 通过 Login Items 注册,openAsHidden 在较新系统上语义有变化 |
| Windows | 写入注册表 Run 项,安装路径变化后需要重新设置 |
| Linux | 需自行写入 .desktop 文件到 autostart 目录 |
典型场景:
Electron 的自动更新有两套常见方案:
| 方案 | 依赖 | 平台 | 适用 |
|---|---|---|---|
内置 autoUpdater | Squirrel(Windows)/ Squirrel.Mac | Windows、macOS | 简单场景,自建更新源 |
electron-updater | electron-builder 生态 | Windows、macOS、Linux(部分) | 通用 provider、差分包、灰度 |
electron-updater| 现象 | 常见原因 |
|---|---|
| Windows 通知不显示 | 未设置 AppUserModelId、应用未正确安装 |
| 协议唤起无效 | 未注册成功、开发模式注册路径错误、Info.plist 缺失 |
| 开机自启失效 | 安装路径变化、系统权限限制、Linux 未写 desktop 文件 |
| 更新下载失败 | 证书、代理、更新源地址、CSP/网络策略 |
| 托盘图标模糊 | 未提供高分辨率图或未使用 Template 图 |
| 全局快捷键无效 | 被其他应用占用、注册时机过早 |
open-url 与 Windows second-instance。