【原创】从零开始搭建Electron+Vue+Webpack项目框架（五）预加载和Electron自动更新

标签：target   common   hunk   关闭   文本   cal   ready   程序启动   相关   

导航：

（一）Electron跑起来
（二）从零搭建Vue全家桶+webpack项目框架
（三）Electron+Vue+Webpack，联合调试整个项目
（四）Electron配置润色
（五）预加载及自动更新
（六）构建、发布整个项目（包括client和web）（未完待续）

摘要：到目前为止，我们的项目已经具备了PC客户端该有的一些基础功能和调试环境，但是总感觉缺了灵魂，那就是结合实际项目、实际业务的细节处理，缺着吧。。。这篇文章就介绍一下预加载和自动更新，文字功底有限，如有介绍的不清楚的地方，欢迎留言指正，或者跳过文字，直接去看代码，项目完整代码：https://github.com/luohao8023/electron-vue-template，随博客更新。

一、预加载

1、什么是预加载？什么场景能用到？　

preload String (可选) -在页面运行其他脚本之前预先加载指定的脚本 无论页面是否集成Node, 此脚本都可以访问所有Node API 脚本路径为文件的绝对路径。 当 node integration 关闭时, 预加载的脚本将从全局范围重新引入node的全局引用标志。

摘自electron官网的一段介绍，https://www.electronjs.org/docs/api/browser-window。

preload是BrowserWindow类的参数webPreferences的一个可选配置项，我们解读一下官网的介绍：

在页面运行其他脚本之前预先加载的指定的脚本：首先是个js文件没错了，再看加载时机，在页面运行其他脚本之前预先加载，这个页面不是普通的某个h5页面，而是指某个渲染进程（需要预加载js的渲染进程，因为渲染进程可能有多个，每个就是一个窗口），我们new一个BrowserWindow，打开了一个窗口，就是启动了一个渲染进程，如果我们不给这个窗口指定页面，那它就是空白的，如果指定了页面，那么窗口就会加载这个页面：

    const win = new BrowserWindow({
        width: 800,
        height: 600
    });
    win.loadURL(‘https://www.baidu.com‘);

如上面代码，我们创建了一个窗口，然后加载百度首页，而preload脚本的加载时机就是窗口创建后，百度首页加载之前。如果有人问，如果不调用loadURL方法，不加载页面，preload脚本会加载吗？答案是会，但有什么用呢？你起个壳子不给人家看页面是什么鬼？不管这些，重要的是我们理解这个加载时机就好了；

无论页面是否集成Node，此脚本都可以访问所有Node API：首先要说明的一点是，Electron5.x以上版本，默认无法在渲染进程中访问Node API，如需使用，需要预先配置：

    const win = new BrowserWindow({
        width: 800,
        height: 600,
        webPreferences: {
            nodeIntegration: true
        }
    });

然后还要清楚一点，preload脚本是运行在渲染进程中的，可以仔细考虑一下。再有一点就是，preload脚本中可以访问window对象（渲染进程其实就是起了个浏览器壳子），preload脚本运行在渲染进程，提前于页面和其他所有js的加载，又能访问Node API；

脚本文件路径为绝对路径，当node integration关闭时，预加载的脚本将从全局范围重新引入node的全局引用标志：结合前面两点理解就好了。

那么，到底什么是预加载？用白话定义一下：

某一个渲染进程，在页面加载之前加载一个本地脚本，这个脚本能访问所有Node API、能访问window对象。用法如下：

    const win = new BrowserWindow({
        width: 800,
        height: 600,
        webPreferences: {
            preload: path.join(__dirname, ‘preload.js‘)
        }
    });

理解应该差不多了，但什么场景能用到这玩意儿呢？按正常的逻辑来想，主进程启动后启动渲染进程，渲染进程加载页面就完事儿了，哪会用到这个preolad呢？

想一下，如果我们有以下场景：

a、如果我们启动了一个窗口（渲染进程），加载了一个线上的页面，本地没有页面文件，但要做一些错误处理，比如网络错误，页面加载失败，然后在页面空白但时候插入一些元素；

b、如果我们的一套代码部署在web端和客户端，需要用一个变量判断是在web端还是客户端；

...........

感觉举的例子好勉强啊，不要见怪，就是大概这么个意思，没准哪天就遇到了非preload解决不了的问题呢，毕竟这玩意儿还是有它的特殊之处的；

上面两个场景如果用preload来解决的话，思路是利用prelaod中能访问window对象的特点，比如b，代码中可以用window.isClient来判断是否在客户端，默认为false，然后在preload中把window.isClient设置为true，而对于部署在web端的代码来说，这个值就是false。

2、怎么用？

上面说了怎么引用preload脚本，现在说一下怎么写，下面开始xxoo乱写乱画了：

// 访问electron对象
const {
    remote,
    ipcRenderer
} = require(‘electron‘);
// 访问node模块
const fs = require(‘fs‘);
const path = require(‘path‘);
// 访问window对象
window.isClient = true;
window.sayHello = function() {
    console.log(‘hello‘);
};
// 操作dom
const div = document.createElement(‘div‘);
div.innerText = ‘I am a div‘;
document.body.appendChild(div);
// ...

如果preoad里面逻辑比较复杂，有可能还要用webpack打包一下，单独拎出来打包就行了，webpack单文件打包，注意targer要"electron-renderer"：

/*
Tip:  preload 打包配置
 */
const path=require(‘path‘);
const { dependencies } = require(‘../package.json‘);
module.exports = {
    mode:process.env.NODE_ENV,
    entry: {
        preload:[‘./src/preload/index.js‘]
    },
    output: {
        path: path.join(__dirname, ‘../app/‘),
        libraryTarget: ‘commonjs2‘,
        filename: ‘./[name].js‘
    },
    optimization: {
        runtimeChunk: false,
        minimize: true
    },
    node: {
        fs: ‘empty‘,
        __dirname:false
    },
    module: {
        rules: [
            {
                test: /\.js$/,
                loader: ‘babel-loader‘,
                exclude: /node_modules/
            }
        ]
    },
    externals: [
        ...Object.keys(dependencies || {})
    ],
    resolve: {
        extensions: [‘.js‘],
        alias: {
            ‘@‘: path.resolve(__dirname, "../src"),
            ‘@public‘: path.resolve(__dirname, "../public")
        }
    },
    plugins:[],
    target:"electron-renderer"
}

我相信，总会遇到使用preload就能迎刃而解的问题。

二、自动更新

我们都知道，electron其实是封了个chrome内核，抛开壳子不说，里面运行的其实就是我们的h5页面，而就算我们跑了个空项目，没有任何内容，打包后的安装包也得30M左右，我们希望自己的程序有自动更新功能，但是更新机制是怎样的呢？

如果我们只改动了页面某一处的文本，却要用户更新整个安装包，那显然太不合理了，一是体验不好，二是我们的流量啊......

基于这种考虑，加上electron主进程和渲染进程的划分，那我们可以考虑如下更新机制：

主进程有改动时，那没的说，用户需要更新整个客户端（当然有精力有条件的可以做动态更新，官方好像是说支持，主要是我不会）；渲染进程有改动时，我们只需要把h5包下载到本地然后加载就行了，当然这需要我们打包的时候能把h5包区分出来，在更新后能打开对应版本的h5包。

这里我们称主进程的更新为大版本更新，渲染进程的更新为小版本更新。

1、打包配置修改

为什么突然扯到打包配置修改了呢，因为牵扯到小版本的更新，那我们打包的时候就得把这个“小版本”给打出来，不然更新个??。因为下面还有一篇文章是专门介绍这个Electron-vue项目的打包，所以这里呢就只讲一下怎么把小版本的压缩包给打出来。

修改build.js，思路是：使用webpack打包主进程、打包preload、打包渲染进程，得到可执行文件目录app，然后引入electrin-builder对app目录进行打包，产生一个安装包，然后把渲染进程的文件压缩并标记版本号。这里我们只拣和本节相关的说，就是打包渲染进程和压缩小版本文件，为什么能拆出来说呢，当然是分模块封装的好处啦，各个进程的打包逻辑封装一下拆出来，能随意组合还能复用，否则一个又臭又长的打包脚本文件，很难维护。

具体代码就不贴出来了，太占篇幅，也没什么用，可以到https://github.com/luohao8023/electron-vue-template看完整代码。

2、增加启动页，启动页显示欢迎语等，在这里检查更新

这里我们暂且叫它检查更新页，这个检查更新页是个独立的渲染进程，用户打开程序时首先显示检查更新窗口，但是这个窗口也不一定显示检查更新字样，偷偷的检查就行了，有新版本就提示更新，没有新版本就显示欢迎语。

这儿的逻辑是单独拆分出来的，不能是自动更新的时候把自动更新逻辑本身也给更新了，容易乱套。

修改主进程代码，程序启动时首先启动自动更新窗口：

app.on(‘ready‘, () => {
    //注册快捷键打开控制台事件
    shortcut.register(‘Command+Control+Alt+F5‘);
    mainWindow = updateWin.create();
});

然后注册监听事件，因为自动更新窗口逻辑完成之后需要呼起主窗口，需要主进程来调度：

//启动主窗体
ipcMain.on(‘create-main‘,(event,arg) => {
    // h5页面指向指定版本
    // global.wwwroot.path = arg.newVersionPath ? arg.newVersionPath : __dirname;
    // if (arg.version) setVal(‘version‘,‘smallVersion‘, arg.version);
    indexWin.create();
    mainWindow.destroy();
});

自动更新窗口只需专注于更新逻辑就行了，逻辑结束后呼起主窗口：

        // 更新逻辑看下面伪代码
        const v1 = getOnlineVersion();
        const v2 = getLocalVersion();
        const needUpdate = checkVersion(v1, v2);
        if (needUpdate) {
            downloadVersion();
        }
        
        this.runMain();

在呼起主窗口的同时给主窗口传递参数，并告知主窗口有没有更新版本，以及主窗口需要加载哪个小版本的包，而主窗口在loadURL时也要做下改动：

    let wwwroot = global.wwwroot.path ? global.wwwroot.path : __dirname;
    let filePath = url.pathToFileURL(path.join(wwwroot, ‘index.html‘)).href;

而wwwrot就是当前小版本包的根路径，由主进程来维护，自动更新小版本后会修改这个值，以告诉主进程加载哪个版本。

好了，啰嗦了一大堆，好多地方没贴代码，感觉贴了代码的话，篇幅就不受控制了，还是去github看完整项目吧，自动更新这一块是伪代码，只实现了渲染进程的切换（即自动更新窗口呼起主窗口），具体的更新逻辑实现起来的话还要拿线上版本去比较，这个还是留给大家在实际项目中去调试吧，就是上面这个思路。

好啦，有什么问题可以留言交流，也可以直接去看代码https://github.com/luohao8023/electron-vue-template。

【原创】从零开始搭建Electron+Vue+Webpack项目框架（五）预加载和Electron自动更新

标签：target   common   hunk   关闭   文本   cal   ready   程序启动   相关   

原文地址：https://www.cnblogs.com/kakayang/p/12386918.html