webpack+react+redux+es6开发模式---续
一、前言
之前介绍了webpack+react+redux+es6开发模式 ,这个项目对于一个独立的功能节点来说是没有问题的。假如伴随着源源不断的需求,前段项目会涌现出更多的功能节点,需要独立部署运行。为了更好地管理这些独立的功能节点,我们需要利用webpack进行单独的打包处理,针对不同的功能节点生成不同的配置文件
二、项目结构
1.项目demo目录图片示例
2.apps目录图片示例(project1和project2分别表示两个不同的功能节点)
三、npm-scripts 命令
package.json部分示
接下来,会说明下每个命令的用途。
四、webpack的dll功能
Dll是Webpack最近新加的功能, 我简单介绍一下。
Dll就是一个纯纯的依赖库,它本身不能运行,是用来给你的app引用的。
打包dll的时候,Webpack会将所有包含的库做一个索引,写在一个manifest文件中,而引用dll的代码(dll user)在打包的时候,只需要读取这个manifest文件,就可以了。
这么一来有几个好处:
Dll打包以后是独立存在的,只要其包含的库没有增减、升级,hash也不会变化,因此线上的dll代码不需要随着版本发布频繁更新。
App部分代码修改后,只需要编译app部分的代码,dll部分,只要包含的库没有增减、升级,就不需要重新打包。这样也大大提高了每次编译的速度。
假设你有多个项目,使用了相同的一些依赖库,它们就可以共用一个dll。
1.webpack.config.js中关于Dll的配置如下
webpack.DllPlugin
的选项中, path
是manifest文件的输出路径; name
是dll暴露的对象名,要跟 output.library
保持一致; context
是解析包路径的上下文,这个要跟接下来配置的dll user一致。
如何进行打包呢,接下来就会用到上面提到的scripts命令(package.json文件中)。这里要说的命令是"dll project1"对应的命令,如下。
webpack --display-error-details --progress --colors -p --config config.project1.dll.js
该命令会加载config.project1.dll.js,对应的配置内容如下:
var config = require('./webpack.config');module.exports = config.webpackdll({
key:'project1'
//根目录
,rootPath:__dirname
});
执行"npm run dll project1"命令,会输出两个文件一个是打包好的vendor.dll.js,一个就是manifest-vendor.json。由于在config.project1.dll.js中配置的key值是功能节点的名称"project1",所以生成的两个文件在apps/project1目录下,如下图所示。
其中manifest-vendor.json大致的样子如下图所示。
Webpack将每个库都进行了编号索引,之后的dll user可以读取这个文件,直接用id来引用。文件内容中的"name"对应的值'dll_vendor' 就是 webpack.config.js中关于Dll的配置中 DllPlugin 中关于 name值的配置,如下所示。
new webpack.DllPlugin({path: options.manifestPath||'apps/'+key+'/manifest-[name].json',//manifest.json 文件的输出路径,这个文件会用于后续的业务代码打包
name: options.manifestName||'dll_[name]',// dll 暴露的对象名,要跟 output.library 保持一致
context: options.manifestContext||rootPath,//解析包路径的上下文,这个要跟接下来配置的 webpack.config.js 一致
}),
2.关于Dll user的配置
DllReferencePlugin
的选项中, context
需要跟之前保持一致,这个用来指导Webpack匹配manifest中库的路径; manifest
用来引入刚才输出的manifest文件。
参考:http://www.tuicool.com/articles/NZ77re
五、开发环境
开发人员开发项目的时候,使用 webpack devserver 启动项目。这里接着说一个命令"dev-project1", 如下。
webpack-dev-server --devtool eval --display-error-details --progress --colors --hot --inline --config config.project1.js
config.project1.js的配置内容如下。
var config = require('./webpack.config');//打印启动信息
config.initPrint(__filename);
var path = require('path');
var cwd = process.cwd();//返回运行当前脚本的工作目录的路径
var baseRoot = "./apps/project1/src/"
var options = {
//定义标识名(如果有多个应用,可以写成 应用的名称)
key : 'project1',
//定义各模块的入口
modules : {
bundle: './project1-index.js'//入口
}
//根目录
,rootPath:__dirname
//webpack-dev-server启动的端口
,port:8000
//相对路径
//,path: path.join(__dirname, '')
//编译后的路径
//,filename: '[name]/build/bundle.js'
//定义各种加载器
//,loaders: []
//定义各种插件
//,plugins:[]
//定义路径别名,即:require(alias)
, alias: {
"styles": path.join(cwd, baseRoot + "styles"),
"less": path.join(cwd, baseRoot + "styles/less"),
"actions": path.join(cwd,baseRoot + "actions"),
"constants": path.join(cwd, baseRoot + "constants"),
"images": path.join(cwd, baseRoot + "images"),
"reducers": path.join(cwd, baseRoot + "reducers"),
"stores": path.join(cwd, baseRoot + "stores"),
"modules": path.join(cwd, baseRoot + "modules"),
"components": path.join(cwd, baseRoot + "components"),
"utils": path.join(cwd, baseRoot + "utils"),
"routes": path.join(cwd, baseRoot + "routes"),
"trd": path.join(cwd, baseRoot + "trd"),
}
}
//服务端产出路径
if(process.env.NODE_ENV==='prod') {//生产环境
options.publicPath = '/project1-front';
}else if(process.env.NODE_ENV==='test') {//测试环境
//options.publicPath = '/icop-sampleapp-frontend';
}else{//本地开发环境
}
//构建webpack配置
module.exports = config.webpack(options);
配置中的注解写的很明确了,就不在啰嗦了。关于webpack.config.js中的webpack方法配置如下。
执行 "npm run dev-project1"命令,启动工程,浏览器中输入“http://localhost:8000/apps/project1”,效果如下。
六、生产环境
发布到生产环境上的程序是稳定的,不允许开发人员直接操作。为了提升服务访问的效率,前端工程放到了要tomcat工程下。tomcat项目下的代码还是我们开发人员所看到的的代码?不是了已经!!!最后我要说的命令就是 "build-project1", 如下所示。
set NODE_ENV=prod&&webpack --display-error-details --progress --colors -p --config config.project1.js
这个命令中设置了环境变量 NODE_ENV=prod,根据这个变量的配置,会有不同的 服务端产出路径 的配置。例如, config.project1.js中的示例代码,如下。
//服务端产出路径if(process.env.NODE_ENV==='prod') {//生产环境
options.publicPath = '/project1-front';
}else if(process.env.NODE_ENV==='test') {//测试环境
//options.publicPath = '/icop-sampleapp-frontend';
}else{//本地开发环境
}
那么本地开发环境中对应的这个路径是啥呢?webpack.config.js中的webpack方法中有这样的配置,如下。
output: {path: options.path || path.join(rootPath, 'apps/'+key)//编译后的输出路径
, filename: options.filename || '/build/bundle.js'
, publicPath: options.publicPath || '/apps/'+key//服务端的路径
, chunkFilename: "/build/[name]_[hash].chunk.js"
},
也就是默认的publicPath是'/apps/project1'(因为传递的key值是 'project1')。执行命令"npm run build-project1", 会在project1目录下生成 build文件夹,内如如下。
这些打包出来的文件是 tomcat中对应项目需要的。并且前端项目 project1中index.html也引入了其中的一些文件,如下所示。
如何把我们前端项目 发布到 tomcat上呢?很简单的,新建一个web工程,工程的名称要注意, 要和 生产环境对应的 服务器产出路径一致,即 "project1-front"。web.xml做一下简单配置,如下。
<?xml version="1.0" encoding="UTF-8"?><web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID" version="3.1">
<display-name>project1-front</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
</welcome-file-list>
</web-app>
接下把前端项目功能节点project1目录下面的文件(不包含"src"目录)copy到刚刚新建的web项目(project1-front)中的 WebContent 目录下,如下所示。
最后启动web工程,浏览器中输入"http://localhost:8029/project1-front",效果如下。
七、webpack的CommonsChunkPlugin提取公共代码,以及懒加载方式
相关链接:http://webpack.github.io/docs/long-term-caching.html
在webpack.config.js中webpack方法对应的配置如下所示。
路由各个功能节点的引入方式,变成如下。
比较一下,使用懒加载方式(project1)和不是懒加载方式(project2)build之后产生文件的差异。
apps/project1/build目录
apps/project2/build目录
很明显,懒加载方式可以更好的解决性能问题,加快页面加载速度。不同的功能模块加载对应的chunk文件就可以了。
八、nodejs中exports与module.exports的区别
http://cnodejs.org/topic/5231a630101e574521e45ef8
http://zihua.li/2012/03/use-module-exports-or-exports-in-node/
http://blog.csdn.net/zhou_xiao_cheng/article/details/52759632
http://www.cnblogs.com/pigtail/archive/2013/01/14/2859555.html
九、教训
开始用懒加载模式的时候,启动工程,出现如下错误。
vendor.dll.js:1 Uncaught Invariant Violation: Minified React error #130; visit http://facebook.github.io/react/docs/error-decoder.html?invariant=130&args[]=object&args[]= for the full message or use the non-minified dev environment for full errors and additional helpful warnings.
找了好长时间的原因,竟然是有一个js文件的导出方式的问题,如下。
然而懒加载的时候,使用的require。这也就是为啥 import可以,require不行的原因了。坑了我好久啊!
试了一下,要改成 module.exports = ModuleRouters。这样才不会报错。
十、项目下载地址
https://github.com/hjzgg/webpack-react-redux-next
十一、项目演示地址
http://study.hujunzheng.cn:8000/DEMO_FRONT
以上是 webpack+react+redux+es6开发模式---续 的全部内容, 来源链接: utcz.com/z/384368.html