Electron 文件和 URL 处理事件监听

open-file 事件

在 Electron 应用开发中，我们经常需要处理用户双击打开关联文件的场景。例如，一个 Markdown 编辑器，用户可以在操作系统中双击 .md 文件，自动打开该编辑器并加载文件内容。这就需要用到 Electron 的 open-file 事件。

open-file 事件是 macOS 平台独有的特性，在 Windows 和 Linux 上无效。当用户双击关联的文件图标、从 Finder 中将文件拖放到应用图标上时，就会触发该事件。

下面是监听 open-file 事件的示例代码：

const { app } = require('electron')

app.on('open-file', (event, path) => {
  event.preventDefault()
  console.log(`用户打开了文件: ${path}`)
  // 在这里处理打开的文件...
})

在主进程的 `app` 模块上监听 `open-file` 事件，回调函数接收两个参数：

- `event`: 事件对象
- `path`: 用户打开的文件完整路径

我们可以在回调函数中获取到打开的文件路径，然后进行相应的处理，比如发送到渲染进程加载文件内容等。

注意要调用 `event.preventDefault()` 阻止默认行为，防止应用被多次启动。

## open-url 事件

除了打开文件，Electron 还支持自定义应用级 URL Scheme，让应用可以响应特定的 URL 链接。例如，点击 `myapp://open?name=test` 链接可以打开应用并执行相关操作。

要实现 URL Scheme 功能，首先需要在应用打包配置中注册 Scheme：

```json
{
  "build": {
    "protocols": [
      {
        "name": "myapp",
        "schemes": ["myapp"]
      }
    ]
  }
}

然后监听 open-url 事件来处理 URL 请求：

const { app } = require('electron');

app.on('open-url', (event, url) => {
  event.preventDefault();
  console.log(`收到 URL Scheme 请求: ${url}`);
  // 解析 URL 并执行相关操作...
});

与 open-file 类似，open-url 事件回调接收 event 和 url 两个参数，分别是事件对象和请求的完整 URL。

我们可以将 URL 进行解析，提取出相关参数，然后执行对应的操作，比如打开特定的页面、执行某些命令等。

最佳实践

为了让应用更好地支持打开文件和 URL Scheme，有以下几点最佳实践供参考：

文件关联配置

合理配置应用支持的文件类型，在 package.json 中的 build.fileAssociations 字段中定义
打包时确保将关联图标打包进 app，在 build.fileAssociations 中指定 icon 路径
在应用启动时检查关联是否成功注册，必要时引导用户手动关联

URL Scheme 配置

为应用注册全局唯一的 URL Scheme，避免与其他应用冲突
合理设计 URL 的 path 和 query 参数，提供必要的可扩展性
在不同平台上测试 Scheme 启动和参数传递是否正常

平台差异处理

根据 process.platform 判断当前运行平台，对 open-file、open-url 事件分别处理
必要时提供回退方案，比如在非 macOS 平台上可以考虑使用命令行参数传递文件路径

安全考虑

对传入的文件路径和 URL 进行安全校验和过滤，防止注入攻击
如果涉及敏感数据，考虑对 URL query 参数进行加密传输，不要明文暴露
谨慎处理来自外部的文件和 URL 请求，防止对应用造成破坏

open-file 事件​

最佳实践​

文件关联配置​

URL Scheme 配置​

平台差异处理​

安全考虑​