通过特定协议拉起 electron 应用

发布于:2025-04-22 ⋅ 阅读:(18) ⋅ 点赞:(0)

在 Android 通过 sheme 协议可以拉起其他应用。
electron 应用也可以通过类似特定协议被拉起。
在同时有 web、客户端的应用里,可以通过这种方式在 web 拉起客户端。

支持拉起客户端

  const PROTOCOL = 'xxx'
  if (process.defaultApp) {
    // 这里是开发环境,有启动参数
    if (process.argv.length >= 2) {
      app.setAsDefaultProtocolClient(PROTOCOL, process.execPath, [path.resolve(process.argv[1])]);
    }
  } else {
    app.setAsDefaultProtocolClient(PROTOCOL);
  }

这里注册启动协议得程序运行一次才生效,体验不好。有没有在安装时就生效的实现?同时在卸载时就取消注册?

mac

在electron-builder.yml加配置,xxx是协议名

# 注册客户端启动协议,适用于mac
protocols:
  - name: ' xxx'
    schemes: 
    - 'xxx'

windows

在electron-builder.yml的 build 目录增加installer.nsh文件,比如electron-builder.yml是

directories:
  buildResources: build

就增加build/installer.nsh

!define PROTOCOL_NAME "xxx"
!macro customInstall
  DeleteRegKey HKCU "${PROTOCOL_NAME}"
  WriteRegStr HKCU "${PROTOCOL_NAME}" "" "URL:${PROTOCOL_NAME}"
  WriteRegStr HKCU "${PROTOCOL_NAME}" "URL Protocol" ""
  WriteRegStr HKCU "${PROTOCOL_NAME}\shell" "" ""
  WriteRegStr HKCU "${PROTOCOL_NAME}\shell\Open" "" ""
  WriteRegStr HKCU "${PROTOCOL_NAME}\shell\Open\command" "" "$INSTDIR\${APP_EXECUTABLE_FILENAME} %1"
!macroend

!macro customUnInstall
  DeleteRegKey HKCU "${PROTOCOL_NAME}"
!macroend

除此之外

还要记得本地开发时仍需要注册,不然调试不生效,但程序退出后记得取消注册

app.removeAsDefaultProtocolClient(PROTOCOL, process.execPath, [path.resolve(process.argv[1])]);

处理二次启动时的参数

拉起后希望能处理传参,比如在浏览器通过 xxx://open?a=1拉起,希望能获取到 open,a=1这些参数。由于 mac默认单例和electron实现的原因,在 mac 和 windows 下有些不一样。

mac

  // 处理请求参数
  app.on('open-url', (_, url) => {
    dialog.showErrorBox('Welcome Back from open-url', `You arrived from: ${url}`);
    handleUrl(url);
  });

windows

  app.on('second-instance', (_, commandLine) => {
    const url = commandLine[commandLine.length - 1]
    dialog.showErrorBox('Welcome Back 111', `You arrived from: ${url}`);
    if(url) handleUrl(url);
  });

处理首次启动时的参数

  if (process.argv.length > 1) {
    const url = process.argv.find(arg => arg.startsWith(`${PROTOCOL}://`));
    if (url) handleUrl(url, {fromInit: true});
  }

参考链接

https://www.electronjs.org/docs/latest/tutorial/launch-app-from-url-in-another-app
https://xuxin123.com/electron/url-scheme/


网站公告

今日签到

点亮在社区的每一天
去签到