webpack+react+redux+es6开发模式---续

react

一、前言

  之前介绍了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

回到顶部