详解vue-cli脚手架build目录中的dev-server.js配置文件
本文系统讲解vue-cli脚手架build目录中的dev-server.js配置文件 1.这个配置文件是命令npm run dev 和 npm run start 的入口配置文件,主要用于开发环境 2.由于这是一个系统的配置文件,将涉及很多的模块和插件,所以这部分内容我将分多个文章讲解,请关注我博客的其他文章 3.关于注释 •当涉及到较复杂的解释我将通过标识的方式(如(1))将解释写到单独的注释模块,请自行查看 4.上代码 // default port where dev server listens for incoming traffic
// 下面是webpack-dev-server 监听的端口号,因为没有设置process.env.PORT,所以下面监听的就是config.dev.port即8080 var port = process.env.PORT || config.dev.port // automatically open browser,if not set will be false // 下面是true,至于为啥,本来就是true还要加!!两个感叹号,估计是vue作者装了个逼吧 var autoOpenBrowser = !!config.dev.autoOpenBrowser // Define HTTP proxies to your custom API backend // https://github.com/chimurai/http-proxy-middleware // 下面是解决开发环境跨域问题的插件,我在config目录index.js文章中有介绍,自行查看 var proxyTable = config.dev.proxyTable // 下面是创建node.js的express开发框架的实例,别问我为什么这样,自己看node.js去吧 var app = express() // 把配置参数传递到webpack方法中,返回一个编译对象,这个编译对象上面有很多属性,自己去看吧,主要是用到里面的状态函数 如compilation,compile,after-emit这类的 var compiler = webpack(webpackConfig) // 下面是webpack-dev-middleware和webpack-hot-middleware两兄弟,这两个是黄金组合 // 而vue作者用这两个插件也是用的最基本的形式,详情看(1) (2) var devMiddleware = require('webpack-dev-middleware')(compiler,{ publicPath: webpackConfig.output.publicPath,quiet: true // 使用friendly-errors-webpack-plugin插件这个必须设置为true,具体看我的wepback-dev-config.js }) var hotMiddleware = require('webpack-hot-middleware')(compiler,{ // proxy api requests // handle fallback for HTML5 history API // serve webpack bundle output // enable hot-reload and state-preserving // serve pure static assets // 下面是es6的promise规范,用来处理嵌套请求的 解释 (1)webpack-dev-middleware插件这个插件只能用于开发环境,下面是这个插件的解释 这是一个简洁的webpack包装中间件,这个插件做这个主要为文件做一件事情,就是当文件修改后提交到webpack服务器,然后处理这些修改后的文件 这个插件有一下几个优点 第一,所有的文件都是写在disk上,文件的处理在内存中进行 第二,如果文件在watch模式下被改动,这个中间件将不会为这些老的bundle服务了,如果这些老的bundle上有文件改动,这个中间件将不会发送请求,而是等到当前编译结束,当前最新的文件有改动,才会发送请求,所以你不需要手动刷新了 第三,我会在以后的版本中优化 总结,这个中间件是webpack-dev-server的核心,实现修改文件,webapack自动刷新的功能 安装 npm install webpack-deb-middleware --save-dev 使用方法如下,下面的使用方法也是webpack-dev-server实现的代码 app.use是express的方法,用来设置静态路径 上面的obj1是webpack配置对象,使用webpack方法转换成compiler编译对象,obj2配置的是更新文件打包后的配置,使用 webpackMiddleware处理之后,就返回一个静态路径,方便获取文件关于obj2的配置项,可以自行查阅,必须要添加publicPath 说到这里,我就不卖关子了,简言之我们的静态服务器是node.js,现在文件修改了,webpack-dev-middleware将修改的文件编译后,告诉nodejs服务器哪些文件修改了并且把最新的文件上传到静态服务器,够清楚了吧 (2)webpack-hot-middleware插件这个插件是用来将webpack-dev-middleware编译更新后的文件通知浏览器,并且告诉浏览器如何更新文件,从而实现 Webpack hot reloading 将这两个插件配合起来使用你就可以不需要webpack-dev-sever,即可以自己实现hot-replacement热替换功能,webpack-hot-middleware插件通知浏览器更新文件大致是通过一个json对象实现的,具体实现机制这里不多说了,下面来看具体用法 安装 npm install webpack-hot-middleware --save-dev 在使用了webpack-dev-middleware之后,在添加如下代码即可 (3)connect-history-api-fallback插件因为在开发单页面应用时,总的来说项目就一个页面,如果通过点击刷新按钮并且此时链接指的不是主页的地址,就会404;或者我通过其他的链接比如 /login.html 但是并没有login.html就会报错,而这个插件的作用就是当有不正当的操作导致404的情况,就把页面定位到默认的index.html使用起来也比较简单,记住这样用就可以了 安装 npm install --save connect-history-api-fallback 使用 以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持编程之家。 (编辑:李大同) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |