electron-asar-updater-pro

专业现代化的 electron asar文件更新。支持Windows、Mac 、Linux

优点：Windows 无需额外的 exe，支持C盘Program Files目录下的更新。

建议：因为开发模式下，路径不准确，仅测试代码跑通。完整流程，请将项目编译打包运行测试。

安装

npm i electron-asar-updater-pro

安装要求

Electron >= 13
Node >= 14

示例

1//Main Process
2const Updater = require('electron-asar-updater-pro');
3const options = {
4    api: {url: 'http://www.test.com/api'},
5    debug: true
6}
7const updater = new Updater(options);
8
9ipcMain.handle('updater-check', async (event, data) => {
10    return await updater.check();
11});
12
13ipcMain.handle('updater-update', async (event, data) => {
14    updater.on('downloadProgress', progress => {
15        event.sender.send('updater-download-progress', progress)
16    });
17    await updater.update();
18});
19
20//Renderer Process
21async function check() {
22    try {
23        const result = await ipcRenderer.invoke('updater-check');
24        if(result){
25            await update();
26        }
27    } catch (error) {
28        console.log('检查更新失败');
29        console.log(error);
30    }
31};
32
33async function update() {
34    try {
35        ipcRenderer.on('updater-download-progress', (event, message) => {
36            console.log(message)
37        })
38        await ipcRenderer.invoke('updater-update');
39    } catch (error) {
40        console.log('更新失败');
41        console.log(error);
42    }
43};
44

服务端api json

远程asar文件名可以随意，sha256是指asar文件或者zip文件的hash

{
    "version": "1.1.0",
    "asar": "http://www.test.com/update.asar",
    "sha256": "xxx"
}

如果asar是zip文件，那么结构如下
── update.zip
└── update.asar

构造方法

1options = {
2    api: {
3        url: '', //
4        body: {},   //string或object，服务端可根据这个参数，返回不同的response json
5        method: 'POST|GET', //default POST
6        headers: {}
7    },
8    autoRestart: true,
9    debug: false,
10};
11const updater = new Updater(options);

方法

1await check(); //检查是否有更新，本地版本号和远程版本号比较
2await update(); //更新并重启软件，必须先执行check方法
3stopDownload(); //停止下载，仅限node v15及以上版本。

事件

1updater.on('downloadProgress', progress => {
2    //下载进度
3});
4
5updater.on('status', status => {
6    //Updater.EnumStatus，更新的状态，用作参考。 
7});

静态属性

1Updater.EnumStatus; //更新的状态

其它：

如果你使用了electron-vite 作为脚手架，那么你可能需要配置build.rollupOptions.external: ["original-fs"],，请参考 https://cn.electron-vite.org/config/#%E5%86%85%E7%BD%AE%E9%85%8D%E7%BD%AE

如果你使用了vue-cli-plugin-electron-builder 作为脚手架，那么你可能需要配置externals: ["electron-asar-updater-pro"],，请参考 https://nklayman.github.io/vue-cli-plugin-electron-builder/guide/guide.html#native-modules