webpack + vue 项目 自定义 插件 解决 前端 JS 版本 更新 问题
Webpack 是一个前端资源加载/打包工具。它将根据模块的依赖关系进行静态分析,然后将这些模块按照指定的规则生成对应的静态资源。
它的异步加载原理是,事先将编译好后的静态文件,通过js对象映射,硬编码进打包后的 manifest.xxxx.js 文件中,然后通过JSONP原理按需加载每个chunk。
每个子模块加载完毕之后,浏览器将会进行本地缓存,从而节省了网络带宽。
Webpack编译后的目录结构如下:

从结构目录来看,整个项目的入口就是index.html,我们来看看index.html的内容:
<!DOCTYPE html>
<html>
<head>
<meta charset=utf-8>
<title>www.phpdragon.com</title>
<script></script>
<link href=/static/css/app.4a4f13cfbe19aa22b83c451c96f49338.css rel=stylesheet>
</head>
<body>
<div id=app>
<transition :name=transitionName>
<router-view></router-view>
</transition>
</div>
<script type=text/javascript src=/static/js/manifest.f726e03ee32bcdee633a.js></script>
<script type=text/javascript src=/static/js/vendor.fa5ac3dc9fb740bb48c5.js></script>
<script type=text/javascript src=/static/js/app.af822fb16a16ef70005b.js></script>
</body>
</html>
其中引入了3个js文件,和一个css样式文件。
我们看看manifest.f726e03ee32bcdee633a.js这个js加载器。
找到这段代码:

是不是发现很熟悉!这一段jsonp代码,这就是用来实现按需加载js资源文件的加载器。
讲到了这,从上述代码就引出了一个问题:
当前端脚本重新编译了以后,项目发布采用的是删除重置发布,由于静态文件只加载一次的缘故,会导致按需加载模块时报错:Loading chunk " + e + " failed.
原因是浏览器已经缓存了manifest.f726e03ee32bcdee633a.js这个加载器,然后访问新的导航栏的时候,服务器端已经不存在旧版本的JS静态资源文件了,从而导致系统异常。
解决方法:
方案一:每次都加载项目入口文件 index.html。也就是说服务器端设置index.html文件不缓存、或者通过URL后缀添加随机字符串来解决。
这个方案适合入口URL可变更的系统。但对于ERP这种内部系统来说,可行性不是很好。
由于入口只加载一次,导致点击系统的其他导航栏URL操作,无法做到再次加载index.html文件,刷新浏览器缓存的JS。
第一种方案可以放弃了!
方案二:给每个导航栏路由URL添加随机数。
这个也不行,并不会导致index.html被重新加载。具体原因,请详看源码解析:vue-router源码分析-整体流程
方案三: 系统内部通过ajax请求获取版本信息从而提示更新。
这个可行,但对后端系统有侵入性,需要后端同学配合。对与跨工种跨部门来说,这种方式属于下策。
方案四:
方案二提到了路由,那么vue的路由是否提供了钩子机制,从而进行拦截呢?
官方是提供的,详看官方文档:vue导航钩子。
通过如下这段代码,我们就能实现我们想要的功能了。一、确保了检测的频率。同时也对系统内部的AJAX请求减少侵入性代码。
router.beforeEach((to, from, next) => {
// ...
})
1.最终解决如下:在 main.js 中添加如下代码:
router.beforeEach((to, from, next) => {
axios.get('../static/version.json?_=' + Math.random()).then(response => {
if (200 == response.status) {
if (process.env.VERSION !== response.data.version) {
var message = "系统版本有更新,点击确认加载最新,或按【CTRL + F5】!"
Vue.prototype.$alert(message, '系统提示', {
confirmButtonText: '确定',
callback: function(){
window.location.reload(true);
}
});
return;
}
next();
}
}).catch(err => {
console.error(err);
next();
});
});
2.添加版本变量:

3.给编译环境添加env变量:

4.通过Webpack的编译插件机制,引入 diy-plugin.js 自定义插件脚本,生成版本信息:
'use strict';
var FStream = require('fs');
var Archiver = require('archiver'); //npm install archiver
/**
* 版本信息生成插件
* @author phpdragon@qq.com
* @param options
* @constructor
*/
function DiyPlugin(options) {
this.options = options || {};
this.options.outZipFile = this.options.path + '/front.zip';
!this.options.versionDirectory && (this.options.versionDirectory = 'static');
}
//apply方法是必须要有的,因为当我们使用一个插件时(new somePlugins({})),webpack会去寻找插件的apply方法并执行
DiyPlugin.prototype.apply = function (compiler) {
var self = this;
compiler.plugin("compile", function (params) {
var dir_path = this.options.context + '/' + self.options.versionDirectory;
var version_file = dir_path + '/version.json';
var content = '{"version":' + self.options.env.VERSION + '}';
FStream.exists(dir_path, function (exist) {
if (exist) {
writeVersion(self, version_file, content);
return;
}
FStream.mkdir(dir_path, function (err) {
if (err) throw err;
console.log('\n创建目录[' + dir_path + ']成功');
writeVersion(self, version_file, content);
});
});
});
//编译器'对'所有任务已经完成'这个事件的监听
compiler.plugin("done", function (stats) {
console.log("开始打包压缩编译文件...");
var output = FStream.createWriteStream(self.options.outZipFile);
var archiveZip = Archiver('zip', {zlib: {level: 9}});
archiveZip.on('error', function (err) {
throw err;
});
archiveZip.pipe(output);
archiveZip.directory(self.options.path + '/' + self.options.versionDirectory, self.options.versionDirectory);
archiveZip.file(self.options.path + '/index.html', {name: 'index.html'});
//archive.glob(self.options.path + '/*.*');
archiveZip.finalize();
});
};
const writeVersion = (self, versionFile, content) => {
console.log("\n当前版本号:" + self.options.env.VERSION);
console.log("开始写入版本信息...");
//写入文件
FStream.writeFile(versionFile, content, function (err) {
if (err) throw err;
console.log("版本信息写入成功!");
});
//删除之前的压缩包
FStream.exists(self.options.outZipFile, function (exists) {
if (exists) {
FStream.unlinkSync(self.options.outZipFile);
}
});
}
module.exports = DiyPlugin;
5.在webpack配置文件中添加 diy-plugin.js 编译钩子:

6. ok,至此结束。 执行编译:
npm run build

7. 访问项目,再次编译版本,打开之前的项目界面,点击其他导航菜单,效果如下:

以上,日常的一些开发点滴。
PS:
webpack + vue 项目 自定义 插件 解决 前端 JS 版本 更新 问题的更多相关文章
- webpack+vue项目实战(四,前端与后端的数据交互和前端展示数据)
地址:https://segmentfault.com/a/1190000010063757 1.前言 今天要做的,就是在上一篇文章的基础上,进行功能页面的开发.简单点说呢,就是与后端的数据交互和怎么 ...
- vue新手入门之使用vue框架搭建用户登录注册案例,手动搭建webpack+Vue项目(附源码,图文详解,亲测有效)
前言 本篇随笔主要写了手动搭建一个webpack+Vue项目,掌握相关loader的安装与使用,包括css-loader.style-loader.vue-loader.url-loader.sass ...
- 浅析vue封装自定义插件
在使用vue的过程中,经常会用到Vue.use,但是大部分对它一知半解,不了解在调用的时候具体做了什么,因此,本文简要概述下在vue中,如何封装自定义插件. 在开始之前,先补充一句,其实利用vue封装 ...
- 解决webpack vue 项目打包生成的文件,资源文件均404问题
最近在使用webpack + vue做个人娱乐项目时,发现npm run build后,css js img静态资源文件均找不到路径,报404错误...网上查找了一堆解决办法,总结如下 一.首先修改c ...
- vue-cli的webpack模版项目配置解析-build/dev-server.js
我们在使用vue-cli搭建vuejs项目(Vuejs实例-01使用vue-cli脚手架搭建Vue.js项目)的时候,会自动生成一系列文件,其中就包含webpack配置文件.我们现在来看下,这些配置到 ...
- 手动搭建webpack + vue项目之初体验
在使用vue做开发时,大部分人只会使用官方提供的脚手架搭建项目,脚手架虽然很好用,但想要成为一名优秀的前端开发者,webpack这一道坎是绕不开的,所以我们要学会脱离脚手架,利用webpack手动搭建 ...
- 为 VUE 项目添加 PWA 解决发布后刷新报错问题
为什么要给 VUE 项目添加 PWA 为什么要添加?因为不管是部署在 IIS,还是 nginx,每次应用部署后,再次访问因为旧的 js 已经不存在,所以页面访问的时候会整个报错,报错的结果就是一个白屏 ...
- vue项目及插件
vue项目的创建 方法1: cmd中执行 vue ui vue会创建一个socket,方便快捷 方法2: 命令行建立 vue create v-proj //创建项目名为v-proj的项目文件 > ...
- vue之自定义插件
1.插件的作用 插件通常会为 Vue 添加全局功能,一般是添加全局方法/全局指令/过滤器等 Vue 插件有一个公开方法 install ,通过 install 方法给 Vue 添加全局功能 通过全局方 ...
随机推荐
- print2flash文档在线预览应用(java,.net)
一.背景 前段时间,LZ的boss突然给了出了这样一个需求:将原项目中的所有文章关联的附件TXT.PDF.office相关文件全部以flash的形式在网页上进行展示,便于预览.看似简单的需求,整个研发 ...
- Oozie分布式工作流——从理论和实践分析使用节点间的参数传递
Oozie支持Java Action,因此可以自定义很多的功能.本篇就从理论和实践两方面介绍下Java Action的妙用,另外还涉及到oozie中action之间的参数传递. 本文大致分为以下几个部 ...
- Android开发中遇到的问题(二)——新建android工程的时候eclipse没有生成MainActivity和layout布局
一.新建android工程的时候eclipse没有生成MainActivity和layout布局 最近由于工作上的原因,开始学习Android开发,在入门的时候就遇到了不少的坑,遇到的第一个坑就是&q ...
- Log4j2 + Maven的配置文件示例详解
一.配置Maven:pom.xml <properties> <project.build.sourceEncoding>UTF-8</project.build.sou ...
- 端口转发工具rinetd的安装与配置
端口映射和转发在实际应用中非常常见,比如一个局域网只有一台服务器可以被互联网访问到,那么如果想通过互联网访问局域网中其他的服务,最常用的方式就是在这一台机器上开放端口,然后转发至局域网中其他主机的端口 ...
- 《Attention is All You Need》
https://www.jianshu.com/p/25fc600de9fb 谷歌最近的一篇BERT取得了卓越的效果,为了研究BERT的论文,我先找出了<Attention is All You ...
- How to make an IntelliJ IDEA plugin in less than 30 minutes
Sometimes it is a nice thing to extend an editor to have it do some new stuff, like being able to re ...
- awstats日志分析
nginx日志格式设定,去掉如下行#号 #vim /usr/local/nginx/conf/nginx.conf log_format access '$remote_addr -$remote_u ...
- 熬之滴水成石:最想深入了解的内容--windows内核机制(6)
58 进程和线程(3) 说完进程再说说线程,线程相比于进程其实有更多可说的内容.首先实现线程调用的数据结构是个栈,该栈记录了调用方法的信息这里面也包括了函数调用及返回的地址.线程肯定是属于某个进程,其 ...
- phpBB3.2 自动检测浏览器语言
这是根据HTTP request header里的Accept-Language信息来处理的. 首先看一下Accept-Language的格式 Accept-Language: <languag ...