Angular2 快速入门之环境搭建

Posted on 2015-05-26 11:28 三块石头阅读(75068) 评论(19) 编辑收藏举报

2015.10.14更新：本文的内容已经过期了，Angular2现在已经完全基于TypeScript开发了，可以移步https://github.com/flyingzl/angular2-seed 查看最新代码。

一、题记

写这篇文章呢，主要是想帮助那些想尝鲜Angular2的童鞋们，因为我自己在玩Angular2时碰到了不少坑，而且Angular2语法一直处于变化中，让人很头疼。不过也怪不了Anguar2，因为它现在是处于并长期处于alpha阶段，本文是基于最新的angular2.0.0-alpha.25来写的。

敬告：Angular2.x与Angular1.x是雷锋与雷峰塔的区别，内心脆弱者请慎入，因为你将会遇到各种挫折，各种折腾，所有你必须要有一个坚强的内心！废话少说，我们开始吧！

二、环境搭建

环境搭建？什么？ Angular不就是一个框架么，搞什么环境搭建，不是像angular1那样引入一个angular.js就搞定了么？

亲，你这么想就错了。我前面就说了，Angular2.x与Angular1.x是雷峰与雷峰塔的区别，Angular2.x是不兼容Angular1.x的，所在在框架的构造上，它们是完全不同的。在Angular2.x中，因为其是基于ES6来开发的，所以会有很多第三方依赖。由于很多浏览器还不支持ES6，所以Angular2引入了很多polyfill或者shim, 导致我们引入了第三方依赖。不够直观? 我给你看一下运行一个所谓的"hello world"需要的代码：

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <title>Angular2 Hello world</title>
</head>

<body>
    
    <sample-app>正在加载中...</sample-app>

    <!-- ES6-related imports -->
    <script src="lib/traceur-runtime.js"></script>
    <script src="lib/es6-module-loader-sans-promises.src.js"></script>
    <script src="lib/extension-register.js"></script>
    <script src="lib/reflect.js"></script>
    <script>
    register(System);
    </script>

    <!-- Angular2-related imports -->
    <script src="lib/zone.js"></script>
    <script src="lib/long-stack-trace-zone.js"></script>
    <script src="lib/angular2.js"></script>

    <!-- Application bootstrap logic -->
    <script>
    System.import('app')
        .then(function(app) {
            app.main();
        }, function(e) {
            console.error('Boostrap angular2 failed!', e);
        });
    </script>
</body>

</html>

我想，看到上面的代码，很多童鞋会发出“我靠，我X”的国骂吧。的确，运行Angular2真他妈不容易，真是惊天地，泣鬼神。这里我还要吐槽下官方的“get started"文档，不知道写的鞋什么鬼玩意，你按照那个，很难跑起来。而且和Angular2的版本还不同步，因为它在不断更新中，官方文档会相对比较旧点。

关于上面的代码，大家暂时不要关注它意思是什么，因为我后面会介绍。现在我们关注的是：这些乱七八糟的js文件从哪里来的？我应该从哪里找到这些玩意。

现在，牛逼闪闪的Gulp闪亮登场了！

按照官方的说法，它是基于数据流的构建系统（streaming build system），主要用来让自动化和增强你的工作流程（Automate and enhance your workflow)。简单说，比如我们有时候需要把less编译成css,需要对js进行jshint检查，然后把脚本合并后再进行压缩，通过gulp，我们可以自动化这些过程，一个命令，就全部搞定了。类似的系统还有Grunt。因为本文不是讲解 Gulp的文章，所以大家可以自行google下，或者阅读 gulp开发教程这篇文章，写的还是不错的。还有一个gulp的中文站点，也可以访问下。

貌似有童鞋开始奔溃了：为了跑一个Angular2,我容易么？唉，又要学习新知识咯。这个年代，不涨姿势无法获得快感呀，所以少年别哭，别45°仰望天空，努力吧！

类似于java中的Ant构建工具有一个build.xml文件，在gulp中，我们得有一个gulpfile.js，这个文件定义了我们需要完成的任务。因为里面设计到了很多操作，大家看看就好，别害怕呀。

'use strict';

var gulp = require('gulp'),
    del = require('del'),
    plumber = require('gulp-plumber'),
    rename = require('gulp-rename'),
    traceur = require('gulp-traceur');


var connect = require('gulp-connect'),
    open = require('gulp-open'),
    port = 3456;

var PATHS = {
    src: {
        js: 'src/**/*.js',
        html: 'src/**/*.html'
    },
    lib: [
        'node_modules/gulp-traceur/node_modules/traceur/bin/traceur-runtime.js',
        'node_modules/es6-module-loader/dist/es6-module-loader-sans-promises.src.js',
        'node_modules/systemjs/lib/extension-register.js',
        'node_modules/angular2/node_modules/zone.js/dist/zone.js',
        'node_modules/angular2/node_modules/zone.js/dist/long-stack-trace-zone.js',
        'node_modules/reflect-metadata/Reflect.js',
        'node_modules/reflect-metadata/Reflect.js.map',
    ]
};


gulp.task('watch', function() {
    gulp.watch(PATHS.src.js, ['js']);
    gulp.watch(PATHS.src.html, ['html']);
});

gulp.task('js', function() {
    return gulp.src(PATHS.src.js)
        .pipe(rename({
            extname: ''
        })) //hack, see: https://github.com/sindresorhus/gulp-traceur/issues/54
        .pipe(plumber())
        .pipe(traceur({
            modules: 'instantiate',
            moduleName: true,
            annotations: true,
            types: true,
            memberVariables: true
        }))
        .pipe(rename({
            extname: '.js'
        })) //hack, see: https://github.com/sindresorhus/gulp-traceur/issues/54
        .pipe(gulp.dest('dist'));
});

gulp.task('html', function() {
    return gulp.src(PATHS.src.html)
        .pipe(gulp.dest('dist'));
});

gulp.task('angular2', function() {

    var buildConfig = {
        paths: {
            "angular2/*": "node_modules/angular2/es6/prod/*.es6",
            "rx": "node_modules/angular2/node_modules/rx/dist/rx.js"
        },
        meta: {
            // auto-detection fails to detect properly here - https://github.com/systemjs/builder/issues/123
            'rx': {
                format: 'cjs'
            }
        }
    };

    var Builder = require('systemjs-builder');
    var builder = new Builder(buildConfig);

    return builder.build('angular2/angular2', 'dist/lib/angular2.js', {});
});

gulp.task('libs', ['angular2'], function() {
    var size = require('gulp-size');
    return gulp.src(PATHS.lib)
        .pipe(size({
            showFiles: true,
            gzip: true
        }))
        .pipe(gulp.dest('dist/lib'));
});



gulp.task('connect', function() {
    connect.server({
        root: __dirname + '/dist',
        port: port,
        livereload: true
    });
});

gulp.task('open', function() {
    var options = {
        url: 'http://localhost:' + port,
    };
    gulp.src('./index.html')
        .pipe(open('', options));
});

gulp.task('build', ['js', 'html'])
gulp.task('default', ['build', 'libs']);
gulp.task('serve', ['connect', 'open']);
gulp.task('clean', function(done) {
    del(['dist'], done);
});

代码比较多呀，不过没关系，我们可以不用太关注你实现细节，关注其运行效果即可，也可以顺便关注下 gulp.task 这个函数，因为我们定义的任务都是靠它来完成的。

哦，对了，值得提醒下， gulp 是基于node.js开发的，所有各位童鞋必须配置好node.js环境，然后安装好gulp，安装很简单。只需要：

npm install gulp -g

关于上面的那个gulpfile.js文件，我简单说下它的功能：

对angular2源码进行转换，将es6代码转换为es5代码，然后合并成angular2.js，放入dest/lib目录
将angular2的第三方依赖放入dest/lib目录
自动监测用户写的代码，当文件发生修改时，自动将其编译为es5代码，然后放入dest目录
开启一个本地服务器，让用户访问http://localhost:3456/ 就可以看到页面效果
删除dest目录

所以，如果我们想构建angular2及其所有的依赖文件，只需要在命令行下输入二句话即可：

gulp // gulp其实相当于运行gulp default, Gulp有一个默认的任务就是default

gulp serve // 在新一个终端运行该命令，开启本地服务器

运行上面的命令，大家会看到错误。为啥，因为我们在Gulpfile.js中引入一些第三方插件，而且我们还没有看到angular2的代码呢，所以接下来，我们需要下载angular2的代码，然后把第三方依赖都安装上。

如果大家熟悉node.js，我们直接定义一个package.json文件即可，这个文件定义好了我们所需的依赖和版本。如下所示：

{
  "name": "angular2-seed",
  "version": "0.2.0",
  "description": "",
  "main": "index.js",
  "author": "flyingzl(flyingzl@gmail.com)",
  "repository": {
    "type": "git",
    "url":  "https://github.com/flyingzl/angular2-seed"
  },
  "license": "MIT",
  "devDependencies": {
    "del": "~1.1.1",
    "gulp": "~3.8.10",
    "gulp-connect": "^2.2.0",
    "gulp-plumber": "^1.0.0",
    "gulp-open": "^0.3.2",
    "gulp-rename": "~1.2.0",
    "gulp-size": "^1.2.1",
    "gulp-traceur": "0.17.*",
    "systemjs-builder": "^0.10.3",
    "through2": "~0.6.3"
  },
  
  "dependencies": {
    "angular2": "2.0.0-alpha.25",
    "es6-module-loader": "0.16.5",
    "systemjs": "0.16.7",
    "reflect-metadata": "0.1.0"
  }
}

在目录下运行 npm install, 程序就会自动下载好相关依赖文件，并且放到 node_modules文件夹，这个时候再运行gulp命令就可以正常运行了，这样运行Angular2所需要的必要条件都满足了。看下运行结果：

好了，今天就到这里了，好像说了很多废话。其实这些都是我们工作的基础，大家不要嫌麻烦。下次我们来构建传说中的 Hello world。

如果大家迫不及待的想看到效果，就看我的github上的angular2-seed吧，这个是一个快速构建angular2的小工程。

刷新页面返回顶部

三块石头

公告

Angular2 快速入门 之 环境搭建

Angular2 快速入门之环境搭建