React项目实战:环境搭建

前言

前面提到前端大统一的概念,如果感兴趣,欢迎说说自己的看法,点击前往。Web前端框架层出不穷,不可能面面俱到,这里给个小建议:

  • 如果对Weex App感兴趣,应该选择vue框架;
  • 如果对React Native App感兴趣,应该选择React.js框架;

本系列文章是React技术栈,Vue技术栈将会在本系列文章结束后陆续更新。

技术栈

由于本系列的文章是项目实战,需要有相关的技术基础,可以到下方给出的链接进行深入学习。项目实战用到的主要框架和插件有:

  • webpack:预编译模块打包工具。 官方文档 - 中文翻译
  • React:构建用户界面的JavaScript库。 官方文档 - 中文翻译
  • Redux:管理整个应用的数据流。 官方文档 - 中文翻译
  • react-router:React应用路由库。 官方文档
  • styled-components:React中的CSS最佳实践。 官方文档
  • isomorphic-fetch:fetch兼容库。 官方文档
  • JRoll2:移动前端滑动插件。 官方文档
  • ECharts:基于html5 Canvas图表库。 官方文档

建议学习时以官方文档为准,中文翻译或者第三方作者的教程可以帮助你理清思路;会用到的重要知识点我也会进行简明的解释,如遇到错误或者不理解的内容,欢迎实时指出。

环境搭建

环境搭建是最为枯燥和最容易出错的地方,不过作为开发者,我们还是很有必要了解配置的具体步骤,在后面一段时间会发布一个简易版环境搭建教程。

系统环境:Win10 + 关闭安全管家

Node.js安装

到官方网站下载安装包 点击前往,选择LTS版本(9.0以后的版本在安装styled-components时会报错)。

npm部署

npm更新并部署至全局

npm install npm  -g

#【可选】设置淘宝镜像
npm config set registry https://registry.npm.taobao.org

npm常用命令:

npm init    #引导创建package.json文件
npm install ***    #本地安装;会在当前目录生成node_modules文件夹,并在此安装node模块
npm install *** -g    #全局安装;会在C:\Users\***\AppData\Roaming\npm\node_modules安装
npm install *** --save    #运行时依赖的模块;自动把模块和版本号添加到package.json文件dependencies部分
npm install *** --save-dev    #开发时依赖的模块;自动把模块和版本号添加到package.json文件devdependencies部分
npm update ***    #更新node模块
npm uninstall ***    #卸载node模块

创建package.json文件

项目根目录:D:\web\react-webapp-demo,请根据自己实际情况设置。

cd D:\web\react-webapp-demo    #在PowerSell中打开项目目录
npm init -y    #跳过提问阶段,直接生成一个新的 package.json 文件。

安装模块

npm install --save react react-dom redux react-redux redux-logger redux-thunk react-router react-router-redux@next history styled-components isomorphic-fetch jroll jroll-pulldown jroll-infinite echarts babel-polyfill
npm install --save-dev webpack webpack-dev-server webpack-merge clean-webpack-plugin babel-loader babel-core babel-preset-env babel-preset-react css-loader style-loader file-loader url-loader html-webpack-plugin uglifyjs-webpack-plugin

模块简要说明:

react react-dom:React依赖
redux react-redux redux-logger redux-thunk:Redux依赖
react-router react-router-redux history:react-router依赖
styled-components:React中的CSS的实现依赖
isomorphic-fetch:fetch兼容库
jroll jroll-pulldown jroll-infinite:JRoll插件依赖
echarts:基于html5 Canvas图表库
babel-polyfill:用于实现浏览器不支持原生功能的代码
webpack:预编译模块打包
webpack-dev-server:实时重新加载的Web服务器
webpack-merge:webpack配置分离插件
clean-webpack-plugin:在building之前删除你以前build过的文件
babel-loader babel-core babel-preset-env babel-preset-react:转码器babel依赖
css-loader style-loader file-loader url-loader:各格式文件打包依赖
html-webpack-plugin:生成HTML5文件的插件
uglifyjs-webpack-plugin:代码压缩插件

配置模块

在项目根目录生成.babelrc文件(Windows系统下文件重命名为.babelrc.),并写入如下数据

{
    "presets": ["env","react"]
}

配置package.json:运行npm run build启动编译模式和npm run start热更新模式;

"scripts": {
    "start": "webpack-dev-server --config webpack.dev.js",
    "build": "webpack --config webpack.prod.js"
},

根目录新建webpack配置文件:webpack.common.jswebpack.dev.jswebpack.prod.js;

webpack.common.js(共用配置)

const path = require('path');
const CleanWebpackPlugin = require('clean-webpack-plugin');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const webpack = require('webpack');

module.exports = {
    entry: ['babel-polyfill','./src/index.js'],    //项目的起点入口
    output: {    //项目输出配置
        path: path.resolve(__dirname, 'build'),    //文件的输出目录 
        filename: 'static/js/[name].[hash:5].js'
    },
    module: {    //模块加载
        rules: [
            {
                test: /\.css$/,    //匹配规则
                use: [
                    { loader: "style-loader" },
                    { loader: "css-loader" }
                ]
            },{
                test: /\.(js|jsx)$/,
                exclude: /node_modules/,
                use: {
                    loader: 'babel-loader'
                }
            },{
                test: /\.(png|svg|jpg|gif)$/,
                use: {
                    loader: 'url-loader',
                    options: {
                        limit: 8192,    //小于8192B的文件转为base64文件
                        name: 'static/images/[name].[hash:5].[ext]'
                    }
                }
            }
        ]
    },
    plugins: [    //插件配置
        new CleanWebpackPlugin(['build']),    //清空编译输出文件夹
        new HtmlWebpackPlugin({
            title: 'Cinglong\'s Demo',
            filename: 'index.html',
            template: path.resolve(__dirname, 'templates', 'index.html')
        }),    //生成Html5文件
        new webpack.optimize.CommonsChunkPlugin({
            name: 'commons'
        }),    //共用代码打包
    ]
};

webpack.dev.js(开发配置)

const merge = require('webpack-merge');
const common = require('./webpack.common.js');
const webpack = require('webpack');

module.exports = merge(common, {
    devtool: 'inline-source-map',    //代码关联显示方式
    devServer: {
        historyApiFallback:true,    //文件重定向,和react-router相关
        hot: true,    //开启模块热替换
        port: 80,    //服务器端口
        host: "192.168.23.101",    //服务器域名
        open: true    //自动打开浏览器标签
    },
    plugins: [
        new webpack.NamedModulesPlugin(),    //显示模块的相对路径
        new webpack.HotModuleReplacementPlugin()    //加载热替换插件
    ]
});

webpack.prod.js(预编译配置)

const merge = require('webpack-merge');
const UglifyJSPlugin = require('uglifyjs-webpack-plugin');
const common = require('./webpack.common.js');

module.exports = merge(common, {
    plugins: [
        new UglifyJSPlugin()    //代码压缩
    ]
});

项目目录

 react-webapp-demo
  |- /node_modules    //模块安装目录
  |- /src    //代码目录
    |- /container    //容器组件
    |- /presentational    //展示组件
      |- /images    //图片目录
    |- /reducers    //reducers操作
    |- /utils    //其他
    |- index.js    //项目入口
  |- /templates    //模板目录
  |- .babelrc    //babel编译配置
  |- package.json    //项目目录配置
  |- package-lock.json    //模块信息(自动生成)
  |- webpack.common.js    //webpack共用配置
  |- webpack.dev.js    //webpack开发配置
  |- webpack.prod.js    //webpack编译配置

系列目录

  1. 前端大统一时代即将来临?
  2. React项目实战:环境搭建
  3. React项目实战:react-redux-router基本原理

你可能感兴趣的:(React项目实战:环境搭建)