使用yarn 制作一个webpack + react 种子
前言
很早以前写过使用React-router和Webpack快速构建一个react程序。很多网友发现版本太老，于是乎最近又重新组织了下结构，使用最近发布的yarn作为包管理工具,介绍下基本安装步骤。并且这次代码包提到了github上，这样大家也可以有个直接参考。
初始化项目
首先确保你的node 版本 >=4.0.并且确保yarn可以正常工作，关于安装yarn，你可以看这里
我们先创建个空文件夹 比如yarn-react-webpack-seed,然后输入命令：
yarn init
yarn 如果没有安装，全程用 npm代替也没问题。
项目会初始化 package.json ,然后填写一些基本信息即可。
接下来我们开始安装依赖项，再 package.json 的添加下面内容
"dependencies": {
"react": "^15.4.0-rc.4",
"react-dom": "^15.3.2",
"react-router": "^2.8.1"
},
"devDependencies": {
"babel": "^6.5.2",
"babel-core": "^6.17.0",
"babel-loader": "^6.2.5",
"babel-preset-es2015": "^6.16.0",
"babel-preset-react": "^6.16.0",
"history": "^4.3.0",
"react-hot-loader": "^3.0.0-beta.6",
"webpack": "^1.13.2",
"webpack-dev-server": "^1.16.2"
},
运行命令:
yarn install
你也可以自行添加依赖，输入yarn add xxx即可。
yarn add react
yarn add webpack --dev
...
项目创建好后，我们接下来创建一些必要的文件和目录；
+ build
+ src
- webpack.config.js
- package.json
- index.html
- server.js
webpack
webpack （更多）是一款模块处理器，他会将你所有的代码打包成静态文件，放到你的开发的App中。
打开webpack.config.js，然后添加下面的代码:
var webpack = require('webpack');
module.exports = {
entry: [
"webpack-dev-server/client?http://localhost:9000",
'webpack/hot/only-dev-server',
"./src/index"
],
output: {
path: __dirname + '/build',
filename: "bundle.js",
publicPath: '/build/',
},
module: {
loaders: [
{
test: /\.js?$/,
loaders: ["react-hot-loader/webpack",'babel-loader?presets[]=react,presets[]=es2015'],
exclude: /node_modules/
},
{
test: /\.less$/,
loader: "style!css!less"
}
]
},
plugins: [
new webpack.NoErrorsPlugin(),
new webpack.HotModuleReplacementPlugin()
]
};
这份文件大概有四个配置项entry, output, module, plugins.
entry:指定打包的入口文件，每有一个键值对，就是一个入口文件。
output：配置打包结果，path定义了输出的文件夹，filename则定义了打包结果文件的名称，filename里面的[name]会由entry中的键替换,例子中的/build/bundle.js便是生成的文件。
module：定义了对模块的处理逻辑，这里可以用loaders定义了一系列的加载器，以及一些正则。当需要加载的文件匹配test的正则时，就会进行处理。这里我们使用了react-hot 和 babel。babel-loader是我们使用ES-6进行开发时用于生成JS文件。
loader对文件进行处理，这正是webpack强大的原因。比如这里定义了凡是.js结尾的文件都是用babel-loader做处理，而.jsx结尾的文件会先经过jsx-loader处理，然后经过babel-loader处理。yarn add添加这些插件。babel中的preset配置你也可以.babelr文件中定义：
{
"presets": [ "es2015", "react"],
}
plugins: 这里定义了需要使用的插件，比如commonsPlugin在打包多个入口文件时会提取出公用的部分，生成common.js。
这个时候我们再package.json中加入script 字段，
"scripts": {
"start": "node server.js",
"build": "webpack --progress --colors"
}
这个时候我们输入一个yarn start命令时候我们会启动一个webpack server这个时候你可以访问 http://localhost:9000/ 看到我们的页面了; 如果你使用yarn run build时候可以将文件自动生成到bulid/下。
接下来我们新建index.html文件
<!doctype html>
<html lang="en" >
<head>
<meta charset="UTF-8">
<title>React+React-Router+Webpack+Yarn Seed</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no">
</head>
<body >
<div id="app"></div>
<script src="./build/bundle.js"></script>
</body>
</html>
在index.html中最重要的是引入 bundle.js,实际上index.html你可以随意修改任何代码，重要是的引入生成后的文件以及含有react渲染的DOM。
React-router
完成项目的基本创建，接下来我们创建src/index.js项目的入口文件。代码如下:
import React from 'react';
import ReactDOM from 'react-dom';
import App from './app';
ReactDOM.render(<App />, document.getElementById('app'));
接下来我们再创建一些包含路由组件的文件src/app.js
import React, { Component } from 'react';
import { render } from 'react-dom';
import { Router, Route, hashHistory } from 'react-router';
// components
import Links from './components/links.js';
import Start from './components/start.js';
import Guide from './components/guide.js';
import How from './components/how.js';
class App extends Component {
render() {
return (
<Router history={hashHistory}>
<Route path="/" component={Links}>
<Route path="/start" component={Start}/>
<Route path="/how" component={How}/>
<Route path="/guide" component={Guide}/>
</Route>
</Router>
);
}
}
export default App;
头部是我们将要用的react和react-router的模块引进来。
同时我们把用到的组件Links,Start,Guide等引进来。然后我们需要配置router
在Route中设置具体的path 和组件。
接下来我们看看如何进行路由的切换，这些内容存放到src/components/links.js中。
import React from 'react';
import { Link } from 'react-router'
let Links = React.createClass({
render() {
return(
<div>
<aside>
<h4>Categories</h4>
<ul role="nav">
<li><Link to="/start" activeStyle={{color:'#3498db'}}>Start</Link></li>
<li><Link to="/how" activeStyle={{color:'#3498db'}}>How</Link></li>
<li><Link to="/guide" activeStyle={{color:'#3498db'}}>Guide</Link></li>
</ul>
</aside>
<div className="page main">
{this.props.children}
</div>
</div>
);
}
});
export default Links;
在Link 中我们可以指定具体的路由地址。
剩下的就是添加组件了，比如我们添加一个简单的start.js到components下面。
import React from 'react';
let Start = React.createClass({
render() {
return(
<div className="c-home">
<img alt="guide" src="http://img1.vued.vanthink.cn/vuedd144134a46129d7068d36025d64ba905.png" />
<h4>React+React-Router+Webpack+Yarn Seed</h4>
</div>
);
}
});
export default Start;
其他的组件代码就不详细展示了。
这个时候我们输入yarn run build,我们可以看到build下会生成一个bundle.js 文件。
如果输入 yarn run start就可以看见页面了
本地输入 yarn start 然后访问 http://localhost:9000 就可以看到自己写的内容了。
关于React-Router的更多配置，可以参考官方文档的教程。
发布
实际上我们有很多方法可以上线你的服务，但是非常好的一件事情是webpack 可以轻松的使用生成的文件。其中你可以快速的将这些资源文件放到cdn上，然后将index.html放到主机上，更新我们的脚本路径就可以了。
这次改变用yarn的安装速度确实比原来npm快了很多几乎都是10s内就完成了。不需要长时间等待或者切换taobao npm 镜像。
使用中的任何问题或者建议，可以直接反馈到项目的issue