天天看点

Angular 2 TypeScript 环境配置

本章节使用的是 TypeScript 来创建 Angular 的应用,这也是官方推荐使用的,本教程的实例也将采用 TypeScript 来编写。

TypeScript 是一种由微软开发的自由和开源的编程语言,它是JavaScript的一个超集,扩展了JavaScript的语法。

如果你不了解TypeScript,可以查阅以下资料:

TypeScript 入门教程

TypeScript 中文手册

这开始前,你需要确保你已经安装了 npm,如果你还没安装npm或者不了解 npm 可以查看我们的教程:NPM 使用介绍。

由于 npm 官网镜像国内访问太慢,这里我使用了淘宝的npm镜像,安装方法如下:

执行后我们就可以使用 cnpm 命令来安装模块:

Angular 项目需要以下几个配置文件:

<b>package.json</b> 标记本项目所需的 npm 依赖包。

<b>tsconfig.json</b> 定义了 TypeScript 编译器如何从项目源文件生成 JavaScript 代码。

<b>typings.json</b>为那些 TypeScript 编译器无法识别的库提供了额外的定义文件。

<b>systemjs.config.js</b> 为模块加载器提供了该到哪里查找应用模块的信息,并注册了所有必备的依赖包。 它还包括文档中后面的例子需要用到的包。

在 angular-quickstart 中创建以下几个文件,代码如下所示:

{

"name": "angular-quickstart",

"version": "1.0.0",

"scripts": {

"start": "tsc &amp;&amp; concurrently \"npm run tsc:w\" \"npm run lite\" ",

"lite": "lite-server",

"postinstall": "typings install",

"tsc": "tsc",

"tsc:w": "tsc -w",

"typings": "typings"

},

"license": "ISC",

"dependencies": {

"@angular/common": "2.0.0",

"@angular/compiler": "2.0.0",

"@angular/core": "2.0.0",

"@angular/forms": "2.0.0",

"@angular/http": "2.0.0",

"@angular/platform-browser": "2.0.0",

"@angular/platform-browser-dynamic": "2.0.0",

"@angular/router": "3.0.0",

"@angular/upgrade": "2.0.0",

"core-js": "^2.4.1",

"reflect-metadata": "^0.1.3",

"rxjs": "5.0.0-beta.12",

"systemjs": "0.19.27",

"zone.js": "^0.6.23",

"angular2-in-memory-web-api": "0.0.20",

"bootstrap": "^3.3.6"

"devDependencies": {

"concurrently": "^2.2.0",

"lite-server": "^2.2.2",

"typescript": "^2.3.4",

"typings":"^1.3.2"

}

"compilerOptions": {

"target": "es5",

"module": "commonjs",

"moduleResolution": "node",

"sourceMap": true,

"emitDecoratorMetadata": true,

"experimentalDecorators": true,

"removeComments": false,

"noImplicitAny": false

"globalDependencies": {

"core-js": "registry:dt/core-js#0.0.0+20160725163759",

"jasmine": "registry:dt/jasmine#2.2.0+20160621224255",

"node": "registry:dt/node#6.0.0+20160909174046"

/**

* System configuration for Angular samples

* Adjust as necessary for your application needs.

*/

(function (global) {

System.config({

paths: {

// paths serve as alias

'npm:': 'node_modules/'

// map tells the System loader where to look for things

map: {

// our app is within the app folder

app: 'app',

// angular bundles

'@angular/core': 'npm:@angular/core/bundles/core.umd.js',

'@angular/common': 'npm:@angular/common/bundles/common.umd.js',

'@angular/compiler': 'npm:@angular/compiler/bundles/compiler.umd.js',

'@angular/platform-browser': 'npm:@angular/platform-browser/bundles/platform-browser.umd.js',

'@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic/bundles/platform-browser-dynamic.umd.js',

'@angular/http': 'npm:@angular/http/bundles/http.umd.js',

'@angular/router': 'npm:@angular/router/bundles/router.umd.js',

'@angular/forms': 'npm:@angular/forms/bundles/forms.umd.js',

// other libraries

'rxjs': 'npm:rxjs',

'angular2-in-memory-web-api': 'npm:angular2-in-memory-web-api',

// packages tells the System loader how to load when no filename and/or no extension

packages: {

app: {

main: './main.js',

defaultExtension: 'js'

rxjs: {

'angular2-in-memory-web-api': {

main: './index.js',

});

})(this);

接下来我们使用 cnpm 命令来安装依赖包:

执行成功后,angular-quickstart 目录下就会生成一个 node_modules 目录,这里包含了我们这个实例需要的模块,我们可以看下项目的目录结构:

Angular 2 TypeScript 环境配置

我们用 NgModules 把 Angular 应用组织成了一些功能相关的代码块。

Angular 本身是被拆成一些独立的 Angular 模块,这样我们在应用中只需要导入需要的 Angular 部分。

每个 Angular 应用至少需要一个<b>root module(根模块)</b> ,实例中为 AppModule 。

接下来我们在 angular-quickstart 目录下创建 app 目录:

然后在 app 目录下创建 app.module.ts 文件,代码如下所示:

import { NgModule } from '@angular/core';

import { BrowserModule } from '@angular/platform-browser';

@NgModule({

imports: [ BrowserModule ]

})

export class AppModule { }

由于 QuickStart 是一个运行在浏览器中的 Web 应用,所以根模块需要从 @angular/platform-browser 中导入 BrowserModule 并添加到 imports 数组中。

每个 Angular 应用都至少有一个<b>根组件</b>, 实例中为 AppComponent,app.component.ts 文件代码如下:

import { Component } from '@angular/core';

@Component({

selector: 'my-app',

template: '&lt;h1&gt;我的第一个 Angular 应用&lt;/h1&gt;'

export class AppComponent { }

代码解析:

以上代码从 angular2/core 引入了 Component 包。

@Component 是 Angular 2 的装饰器 ,它会把一份元数据关联到 AppComponent 组件类上。

my-app 是一个 CSS 选择器,可用在 HTML 标签中,作为一个组件使用。

@view 包含了一个 template ,告诉 Angular 如何渲染该组件的视图。

export 指定了组件可以在文件外使用。

接下来我们重新打开 app.module.ts 文件,导入新的 AppComponent ,并把它添加到 NgModule 装饰器的 declarations 和 bootstrap 字段中:

import { AppComponent } from './app.component';

imports: [ BrowserModule ],

declarations: [ AppComponent ],

bootstrap: [ AppComponent ]

接下来我们需要告诉 Angular 如何启动应用。

在 angular-quickstart/app 目录下创建 main.ts 文件,代码如下所示:

import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';

import { AppModule } from './app.module';

const platform = platformBrowserDynamic();

platform.bootstrapModule(AppModule);

以上代码初始化了平台,让你的代码可以运行,然后在该平台上启动你的 AppModule。

在 angular-quickstart 目录下创建 index.html 文件,代码如下所示:

&lt;html&gt;

&lt;head&gt;

&lt;title&gt;Angular 2 实例 - 菜鸟教程(runoob.com)&lt;/title&gt;

&lt;meta charset="UTF-8"&gt;

&lt;meta name="viewport" content="width=device-width, initial-scale=1"&gt;

&lt;link rel="stylesheet" href="styles.css"&gt;

&lt;!-- 1. 载入库 --&gt;

&lt;!-- IE 需要 polyfill --&gt;

&lt;script src="node_modules/core-js/client/shim.min.js"&gt;&lt;/script&gt;

&lt;script src="node_modules/zone.js/dist/zone.js"&gt;&lt;/script&gt;

&lt;script src="node_modules/reflect-metadata/Reflect.js"&gt;&lt;/script&gt;

&lt;script src="node_modules/systemjs/dist/system.src.js"&gt;&lt;/script&gt;

&lt;!-- 2. 配置 SystemJS --&gt;

&lt;script src="systemjs.config.js"&gt;&lt;/script&gt;

&lt;script&gt;

System.import('app').catch(function(err){ console.error(err); });

&lt;/script&gt;

&lt;/head&gt;

&lt;!-- 3. 显示应用 --&gt;

&lt;body&gt;

&lt;my-app&gt;Loading...&lt;/my-app&gt;

&lt;/body&gt;

&lt;/html&gt;

这里值得注意的地方有:

JavaScript 库: <b>core-js</b> 是为老式浏览器提供的填充库, <b>zone.js</b> 和 <b>reflect-metadata</b> 库是 Angular 需要的,而 SystemJS 库是用来做模块加载的。

SystemJS 的配置文件和脚本,可以导入并运行了我们刚刚在 main 文件中写的 app 模块。

&lt;my-app&gt; 标签是应用载入的地方

我们可以在 angular-quickstart 目录的 styles.css 文件中设置我们需要的样式:

/* Master Styles */

h1 {

color: #369;

font-family: Arial, Helvetica, sans-serif;

font-size: 250%;

h2, h3 {

color: #444;

font-weight: lighter;

body {

margin: 2em;

打开终端窗口,输入以下命令:

访问 http://localhost:3000/,浏览器显示结果为:

Angular 2 TypeScript 环境配置

这样我们的第一个 Angular2 的应用就算创建完成了,最终的目录结构为:

Angular 2 TypeScript 环境配置

本文所使用的源码可以通过以下方式下载,不包含 node_modules 和 typings 目录。

源代码下载