使用 webpack2 和 NPM Scripts 进行 JavaScript 组件开发

• 搭建一个简易环境
• 配置 webpack
  • 生产环境和开发环境
  • 使用 babel 编译 ES6
  • 配置开发调试的 webpack-dev-server
• 创建 NPM Scripts
• 开始项目开发
  • 构建和发布
• 总结

最近 webpack 成为非常流行的打包工具，很多项目都在使用它。在我们进行 JavaScript 独立组件开发的时候，如果我们想要使用语言新特性，又想发布的时候产出兼容性好的代码，那么使用 webpack 就能够很大程度上帮助我们实现这一目标。

现在让我们来看看究竟该怎么做吧。

搭建一个简易环境

首先，第一步是初始化和安装一些必要的依赖，搭建一个简易的开发和调试环境：

# 初始化 package.json
    npm init -i
    # 安装 http-server
    npm install http-server --save-dev
    # 安装 webpack 
    npm install webpack webpack-dev-server --save-dev
    # 安装 babel 和 babel 插件，如果不想使用 babel 编译 ES6+，可以跳过这一步
    npm install babel-loader babel-core babel-preset-env babel-plugin-transform-runtime --save-dev

有了这个基础环境之后，我们来配置一份 webpack.config.js

配置 webpack

我们在项目目录里添加 webpack.config.js

module.exports = function(env = {}){

      const webpack     = require('webpack'),
            path        = require('path'),
            fs          = require('fs'),
            packageConf = JSON.parse(fs.readFileSync('package.json', 'utf-8'));

      let name      = packageConf.name,
          version   = packageConf.version,
          library   = name.replace(/^(\w)/, m => m.toUpperCase()),
          proxyPort = 8081,
          plugins   = [],
          loaders   = [];

      if(env.production){
        name += `-${version}.min`;
        //compress js in production environment
        plugins.push(
          new webpack.optimize.UglifyJsPlugin({
            compress: {
              warnings: false,
              drop_console: false,
             }
          })
        );
      }

      if(fs.existsSync('./.babelrc')){
        //use babel
        let babelConf = JSON.parse(fs.readFileSync('.babelrc'));
        loaders.push({
          test: /\.js$/,
          exclude: /(node_modules|bower_components)/,
          loader: 'babel-loader',
          query: babelConf
        });
      }

      return {
        entry: './lib/app.js',
        output: {
          filename: `${name}.js`,
          path: path.resolve(__dirname, 'dist'),
          publicPath: '/static/js/',
          library: `${library}`,
          libraryTarget: 'umd'
        },

        plugins: plugins,

        module: {
          loaders: loaders
        },

        devServer: {
          proxy: {
            "*": `http://127.0.0.1:${proxyPort}`,
          }
        }
      };
    }

代码比较长，但不复杂，这里我分别解释一下各部分的作用：

生产环境和开发环境

首先我们从 package.json 里面取出一些信息，包括模块名和版本号，我们依赖它们来生成对应的 umd 模块的 library、输出的文件名以及版本号。

在这里我们规定在开发环境时输出 模块名.js，在生产环境发布时输出 模块名-版本号.min.js。

在 webpack2 里，我们可以通过 env.production 获取命令行参数 \--env.production，从而区别是开发环境还是生产环境。

  if(env.production){
        name += `-${version}.min`;
        //compress js in production environment
        plugins.push(
          new webpack.optimize.UglifyJsPlugin({
            compress: {
              warnings: false,
              drop_console: false,
             }
          })
        );
      }

在生产环境中，我们不仅改变输出的文件名，还配置 UglifyJsPlugin 来压缩脚本。

使用 babel 编译 ES6

如果脚本用到 ES6，我们希望用 babel 编译的话，还需要加载 babel-loader 来进行编译。我们采用 babel 的默认配置 .babelrc，在项目目录里添加 .babelrc：

{
      "presets": ["env"],
      "plugins": ["transform-runtime"]
    }

然后我们在 webpack.config.json 里根据配置来添加 loader:

  if(fs.existsSync('./.babelrc')){
        //use babel
        let babelConf = JSON.parse(fs.readFileSync('.babelrc'));
        loaders.push({
          test: /\.js$/,
          exclude: /(node_modules|bower_components)/,
          loader: 'babel-loader',
          query: babelConf
        });
      }

配置开发调试的 webpack-dev-server

最后，为了在开发环境里调试，我们还需要配置 webpack-dev-server:

    devServer: {
          proxy: {
            "*": `http://127.0.0.1:${proxyPort}`,
          }
        }

webpack-dev-server 是一个代理，我们之前安装了 http-server，我们用 webpack-dev-server 来代理它，所以开发时我们让 http-server 运行在 8081 端口：

webpack-dev-server --quiet & http-server -p 8081 -c-1

创建 NPM Scripts

配置好了 webpack，创建 NPM Scripts 是个非常简单的过程：

  "scripts": {
        [...]
        "start": "webpack-dev-server --quiet & http-server -c-1 -p 8081",
        "build-release": "webpack --env.production"
      },

我们在 package.json 里添加两个脚本，这样我们就可以使用 npm start 来启动开发环境，使用 npm run build-release 来发布到生产环境了。

开始项目开发

接下来我们创建 lib/app.js：

module.exports = require('./demo');

然后创建 lib/demo.js:

module.exports = class Demo{
      async test(){
        return new Promise((resolve) => {
          setTimeout(resolve, 1000)
        });
      }
    }

创建 examples/index.html:

<!DOCTYPE html>
    <html lang="en">
    <head>
      <meta charset="UTF-8">
      <title>Demo</title>
    </head>
    <body>
      <h1>Hello</h1>
      <script src="/static/js/demo.js"></script>
      <script>
        var d = new Demo();
        d.test().then(function(){
          console.log('test done!');
        });
      </script>
    </body>
    </html>

运行 npm start，访问 http://localhost:8080/examples/index.html

打开控制台，1秒后就能看到输出 test done。

构建和发布

接下来，我们可以停止开发服务器，运行 npm run build-release。如果你的 package.json 里的版本号是 1.0.0，那么它将在 dist 目录下生成 demo-1.0.0.min.js。这是一个 umd 的包，所以你可以在浏览器中使用 amd/cmd 库加载或者直接在 script 标签中引入和使用。

总结

我们使用 webpack 搭建了一个简单的组件开发环境，这样我们可以简单地开始我们的 JS 组件开发，使用新的语言规范，然后通过 webpack-dev-server 代理 http-server 进行调试，通过 webpack --env.production 进行发布。我们还可以将它们与 NPM Scripts 集成，这样我们的组件开发就非常方便了。

你喜欢的组件开发方式是怎样的？欢迎在评论区讨论。