Angular2开发基础之Webpack

目标

上篇文章Angular2开发基础之TSC编译 解决如何使用TSC来编译ng2项目,以及如何解决出现的error。这些点是新手容易忽视的内容, 要熟悉ng开发的工具链,还是需要掌握其中的重点。
本篇文章是它的姊妹篇,小目标是:

  • package.json加入script
  • webpack.config.js
  • webpack配置完成 app.bundle.js
  • webpack-dev-server
    完整代码 -> 传送门

环境

需要说明,本教程仅是Windows的实操,Linux,Mac环境,会有不同。

  • Windows 10 64位
  • gitBash version 2.9.0.windows.1
  • NodeJs version 6.8.0
  • npm version 3.10.8
  • IntelliJ IDEA 15

效果展示

Angular2开发基础之Webpack_第1张图片
ng2-starter-overview.png

实操

在实操之前,请先仔细阅读 Angular2开发基础之TSC编译
ng-starter-webpack进行到现在,可以使用 tsc命令来编译ng2项目 $(npm bin)/tsc --rootDir src --outDir dist

每次都敲上述命令,肯定不是聪明的选择,需要加入到package.json中完成脚本的编写。

step 1 : scripts

@package.json 中添加如下脚本, 注意, 你可以取 build 为你想要的字符串。

"scripts": {
    "build": "tsc --rootDir src --outDir dist"
  },

然后再终端执行:

npm run build

Look, dist出现,内容跟之前一致。

为了让其他小伙伴download代码后,能直接使用 npm install, 把typings相关的也可以自动download,需要小小修改下package.json 中的 scripts

"postinstall": "typings install",

删除dist, node_moudles, typings 后,使用 npm install,就能下载所有相关依赖库以及文件了。

step 2: 添加Webpack

Webpack 简单的说,就是可以混合src中所有的ts源文件,并且仅仅生成一个bundle.js文件, 还可以进行对生成的js文件混淆。

建议安装全局 -g,这里仅仅安装在根目录

npm install --save-dev webpack

同时,还需要安装 相关loader, 参看 webpack文档,知道,webpack原本仅支持js, 如果需要支持其他如ts,json格式的文件,就需要使用相关的 loader。

npm install --save-dev ts-loader

step 3: webpack.config.js

为了更好的使用webpack,需要使用webpack.config.js来配置webpack。新建webpack.config.js文件。

var webpack = require('webpack');

module.exports = {

    entry: './src/main.ts',
    output: {
        path: './dist',
        filename: 'app.bundle.js'
    },
    module: {
        loaders: [
            {
                test: /\.ts$/,
                loader: 'ts-loader'
            }
        ]
    },
    resolve: {
        extensions: ['', '.js', '.ts']
    },
};

以上内容表达2个意思: ** 1. 从哪里来, 到哪里去 ? 2. 跟你一起,有谁? 3.如何处理扩展名 **
如何理解:

  • entry表示入口是哪个ts, main.ts, 编译完成的目标文件, output指定
  • loaders表示需要load哪些文件进行编译, .ts$文件, 使用哪个loader: ts-loader
  • resolve 表示生成的文件的扩展名,以及编译的文件扩展名等

完成以上,执行

$(npm bin)/webpack --progress

查看 dist目录,只有一个文件app.bundle.js 而且文件很大, 1.53M

webpack编译结果

step4: 运行测试

以上配置好了webpack, 需要进行测试了,等这一刻好久了。
@index.html 添加 app.bundle.js script

Angular 2 starter webpack

然后执行,调试发现,出现error:

Uncaught reflect-metadata shim is required when using class decorators

这是因为webpack不包含任何 reflect-metadata js code 即使这些库文件在package.json中添加了依赖。 所以,需要强制在main.ts中添加这些库文件,包括:

  • reflect-metadata
  • rxjs
  • zone.js
import 'core-js';
import 'reflect-metadata';
import 'zone.js/dist/zone';
... ...

再次运行, $(npm bin)/webpack --progress 得到新的 bundle.js, 而且比之前大了一些。
查看浏览器, 发现还是Loading...
调试发现,还是error,不过这次提示 找不到my-app

F12-error

这个是因为 加载script位置有问题,应该刚在底部标签的上面。

... ...
Loading...

运行浏览器,OK, 完美~ My App出现了!

step 5: 再修改scripts

注意,刚才编译使用的是长命令: $(npm bin)/webpack --progress , 能否像之前使用 npm run build那样 就直接运行 webpack --progress, 可以!
修改package.json -> scripts

"build": "tsc --rootDir src --outDir dist",
"build": "webpack --progress",

step 6: html-webpack-plugin

dist目录生成index.html
注意, index.html是在src目录中,而生成的js是在dist中,webpack能否在执行npm run build 中生成index.html,并且将 对应的app.bundle.js嵌入到index.html文件中。

npm install --save-dev html-webpack-plugin

@完整 webpack.config.js

var webpack = require('webpack');
var HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {

    entry: './src/main.ts',
    output: {
        path: './dist',
        filename: 'app.bundle.js'
    },
    module: {
        loaders: [
            {
                test: /\.ts$/,
                loader: 'ts-loader'
            }
        ]
    },
    resolve: {
        extensions: ['', '.js', '.ts']
    },
    plugins: [
        new HtmlWebpackPlugin({
            template: './src/index.html'
        })
    ]
};

同时,可以删除掉src/index.html 中的 script导入语句


再次运行 npm run build, 奇迹发生了,dist中存在了index.html, 并且文件中存在 了

step 7 : app.bundle.js 瘦身

要实现app.bundle.js瘦身,需要在package中添加某些Magic。

"build:prod": "webpack -p --progress",
npm run build:prod

大小减半了,只有651KB

Angular2开发基础之Webpack_第2张图片
webpack-p-01.png

step 8: webpack-dev-server

在开发中,如何不用每次修改代码后,重复执行编译,运行,刷新页面呢? 推荐使用 webpack-dev-server

npm install --save-dev webpack-dev-server

@package.json -> scripts

"server": "webpack-dev-server --line --progress"
npm run server

在浏览器输入 http://localhost:8080/ 就可以看到效果, 而且,当修改文件时候,server自动编译 刷新页面。Nice! Nice! Nice!

小结:
基本的webpack使用到这里就完结了,需要参看代码的同学,请访问我的 ng2-started-webpack

你可能感兴趣的:(Angular2开发基础之Webpack)