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

效果展示

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

<title>Angular 2 starter webpack</title>
<script src="../dist/app.bundle.js"></script>

然后执行,调试发现,出现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位置有问题,应该刚在<body>底部标签的上面。

... ...
<my-app>Loading...</my-app>
<script src="../dist/app.bundle.js"></script>

运行浏览器,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导入语句

<script src="../dist/app.bundle.js"></script>

再次运行 npm run build, 奇迹发生了,dist中存在了index.html, 并且文件中存在 了<script>标签, 可不是copy,或者添加进入的,是自动生成的。Nice!!!

<script type="text/javascript" src="app.bundle.js"></script></body>

step 7 : app.bundle.js 瘦身

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

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

大小减半了,只有651KB

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350

推荐阅读更多精彩内容