手撸 Electron 自动更新,再繁琐也要搞懂它

2023年 11月 22日 40.4k 0

大家好,我是杨成功。

Electron 的自动更新不会像 React Native 一样直接下载 Web 代码静默更新,因为它还有主进程(Node.js)代码,因此需要走安装流程。

在 Electron 中,使用第三方包 electron-updater 来实现自动更新的功能。

为什么不用 autoUpdater?

如果细看 Electron 文档,会发现官方提供了一个 autoUpdater 功能来实现自动更新,如图:

图片

相比 autoUpdater,第三方包 electron-updater 有以下优势:

  • 不需要搭建专门的更新服务(如 Hazel、Nuts 等)。
  • 同时支持 macOS 和 Windows 签名。
  • 支持获取下载进度,等等。

最主要的优势还是支持自定义更新服务。将新包上传到自己的静态服务器,比专门搭建一个更新服务更方便。

当然获取下载进度也很重要,否则用户干等着,体验非常差。后面我们会实现下载进度提示。

接入 electron-updater

安装 electron-updater,命令如下:

$ yarn add electron-updater

新建 update.js 文件,在该文件中编写更新逻辑。

定义一个 checkUpdate() 方法,在该方法中执行 checkForUpdatesAndNotify() 来检测是否有新版本。

当更新完成后,执行 quitAndInstall() 方法来安装更新后的应用包。代码如下:

const { autoUpdater } = require('electron-updater');
var mainWin = null;

const checkUpdate = (win, ipcMain) => {
  autoUpdater.autoDownload = true; // 自动下载
  autoUpdater.autoInstallOnAppQuit = true; // 应用退出后自动安装
  mainWin = win;
  // 检测是否有更新包并通知
  autoUpdater.checkForUpdatesAndNotify().catch();
  // 监听渲染进程的 install 事件,触发退出应用并安装
  ipcMain.handle('install', () => autoUpdater.quitAndInstall());
};

module.exports = checkUpdate;

上方代码中,我们通过监听渲染进程的 install 事件来安装新包。目的是在下载完新包后先提醒用户是否安装,用户确认安装后才执行安装,强制安装会影响用户使用。

在主进程中检测更新,并通知用户。

检测更新是在主进程中执行的,因此在主进程中调用 checkUpdate() 方法。

checkUpdate() 方法接收两个参数,分别是渲染进程实例和主进程 IPC。主进程代码如下:

const { app, BrowserWindow, ipcMain } = require('electron');
const path = require('path');
const preload = path.join(__dirname, './preload.js');
const checkUpdate = require('./update.js');

app.whenReady().then(() => {
  // 创建浏览器窗口(渲染进程)
  let win = new BrowserWindow({
    width: 600,
    height: 600,
    webPreferences: {
      contextIsolation: false,
      preload,
    },
  });
  checkUpdate(win, ipcMain);
});

上方代码中创建了一个浏览器窗口,并绑定了预加载脚本(preload.js)。预加载脚本负责主进程与渲染进程之间的通信。

现在,客户检测更新的逻辑已经基本实现了。但是有新版本的判断依据是什么呢?又从哪里下载新版本呢?

下面我们编写服务器的逻辑。

客户端打包,上传服务器

检测更新的原理,一定是本地应用版本和线上版本的对比,因此需要将应用打包并上传到服务器。

应用打包使用 electron-builder 实现。

安装 electron-builder 模块:

$ yarn add electron-builder

根目录下创建 electron-builder.json5 配置文件:

{
  ...
  "publish": [
    {
      "provider": "generic",
      "url": "https://xxx/updater/ele-app"
    }
  ]
}

配置文件的可选项有很多,publish 选项是自动更新配置。

其中 url 属性最重要,是线上版本和安装包的地址,检测更新就是通过这个地址检测。

打包之后,我们就要将新的安装包和配置上传到服务器,并通过这个地址访问。

应用打包,生成安装包和版本配置。

应用的版本号取自 package.json 文件中的 version 选项。

假设当前版本号是 0.1.7,我们首先更新版本号为 0.1.8,然后使用以下命令打包:

$ electron-builder --win --x64  # 打包 Windows
$ electron-builder --mac --universal # 打包 Mac Intel
$ electron-builder --mac --arm64 # 打包 Mac M1

以 Window 平台为例,打包后会生成多个文件,以下两个需要上传:

  • xxx_0.1.8.exe(安装包)
  • latest.yml(版本配置)

上传到服务器后,需要通过 publish 中配置的地址访问到,最终访问地址如下:

  • https://xxx/updater/ele-app/xxx_0.1.8.exe:下载安装包。
  • https://xxx/updater/ele-app/latest.yml:检测版本更新。

可见,latest.yml 文件用于检测更新,发现有更新后才会下载对应的安装包。

配置 nginx 使访问地址生效。

我们将上一步的两个文件上传到服务器的 /data/updater/ele-app 目录下,然后在 nginx 配置中添加一个 location 如下:

location /updater {
   add_header Access-Control-Allow-Origin *;
   add_header Access-Control-Allow-Credentials true;
   add_header Access-Control-Allow-Methods GET,POST;
   alias /data/updater;
   sendfile on;
   autoindex on;
}

使用 "nginx -s reload" 重新加载配置,访问文件的地址便生效了。

将下载进度通知给用户

在客户端的 update.js 文件中,我们触发了检测更新,可以添加事件监听检测结果,如下:

autoUpdater.on('update-available', (info) => {
  console.log('有新版本需要更新');
});
autoUpdater.on('update-not-available', (info) => {
  console.log('无需更新');
});

当有新版本时,应用后台会自动下载(因为我们配置了 autoDownload = true),此时监听下载进度并传给渲染进程,用于将其展示到用户界面上。代码如下:

autoUpdater.on('download-progress', (prog) => {
  mainWin.webContents.send('update', {
    speed: Math.ceil(prog.bytesPerSecond / 1000), // 网速
    percent: Math.ceil(prog.percent), // 百分比
  });
});
autoUpdater.on('update-downloaded', (info) => {
  mainWin.webContents.send('downloaded');
  // 下载完成后强制用户安装,不推荐
  // autoUpdater.quitAndInstall();
});

上面代码中,主进程向渲染进程发送了 update 和 downloaded 事件,这些事件需要经过预加载脚本转发。渲染进程发送的 install 事件同理。

因此,在预加载脚本 preload.js 中添加代码如下:

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

window.elecAPI = {
  toInstall: () => ipcRenderer.invoke('install'),
  onUpdate: (callback) => ipcRenderer.on('update', callback),
  onDownloaded: (callback) => ipcRenderer.on('downloaded', callback),
};

现在,在浏览器窗口加载的 HTML 页面中,我们可以直接使用上述代码中的三个方法。

注意:在预加载脚本中使用 window.elecAPI 的前提是禁用上下文隔离,即配置 contextIsolation: false,否则会报错。

显示下载进度,完成后提示安装

在 JavaScript 中调用预加载脚本中的定义方法,即可获取到安装进度,并主动触发安装。

var update_info = null; // 更新信息

window.elecAPI.onUpdate((_event, info) => {
  update_info = info;
});
window.elecAPI.onDownloaded(() => {
  update_info = null;
  let res = confirm('新版本已下载,是否立即安装?');
  if (res) {
    window.elecAPI.toInstall();
  }
});

如果你使用 Vue 或 React 框架,直接将 update_info 定义为状态,即可在页面中以任意方式显示新应用的下载进度了。

比如下图,是我的更新提醒页面:

图片

下载完成后会弹框询问是否安装,确认后应用会退出并安装;如果取消,下一次打开应用后还会继续询问,直到用户安装。

图片

总结

经过上述的好几个步骤,现在要发布新版本,只需要执行 2 个步骤。

  • 更新版本号,打包。
  • 上传到服务器。

现在用户重新打开应用程序,新包就会自动下载,并看到下载进度啦!

相关文章

JavaScript2024新功能:Object.groupBy、正则表达式v标志
PHP trim 函数对多字节字符的使用和限制
新函数 json_validate() 、randomizer 类扩展…20 个PHP 8.3 新特性全面解析
使用HTMX为WordPress增效:如何在不使用复杂框架的情况下增强平台功能
为React 19做准备:WordPress 6.6用户指南
如何删除WordPress中的所有评论

发布评论