Angular 2 TypeScript 环境配置

最后更新于：2022-03-27 02:08:30

Angular 2 TypeScript 环境配置

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

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

如果你不了解TypeScript，可以查阅以下资料：

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

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

$ npm install -g cnpm --registry=https://registry.npmmirror.com

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

$ cnpm install

第一步：创建与配置项目

创建目录

$ mkdir angular-quickstart
$ cd angular-quickstart

创建配置文件

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

  • package.json 标记本项目所需的 npm 依赖包。
  • tsconfig.json 定义了 TypeScript 编译器如何从项目源文件生成 JavaScript 代码。
  • typings.json为那些 TypeScript 编译器无法识别的库提供了额外的定义文件。
  • systemjs.config.js 为模块加载器提供了该到哪里查找应用模块的信息，并注册了所有必备的依赖包。 它还包括文档中后面的例子需要用到的包。

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

package.json 文件：

{
"name": "angular-quickstart",
"version": "1.0.0",
"scripts": {
"start": "tsc && 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"
}
}

tsconfig.json 文件：

{
"compilerOptions": {
"target": "es5",
"module": "commonjs",
"moduleResolution": "node",
"sourceMap": true,
"emitDecoratorMetadata": true,
"experimentalDecorators": true,
"removeComments": false,
"noImplicitAny": false
}
}

typings.json 文件：

{
"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"
}
}

systemjs.config.js 文件：

/**
* 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: {
defaultExtension: ‘js‘
},
‘angular2-in-memory-web-api‘: {
main: ‘./index.js‘,
defaultExtension: ‘js‘
}
}
});
})(this);

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

$ cnpm install

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

第二步：创建应用

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

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

每个 Angular 应用至少需要一个root module(根模块) ，实例中为 AppModule 。

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

$ mkdir app
$ cd app

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

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 应用都至少有一个根组件， 实例中为 AppComponent，app.component.ts 文件代码如下：

app.component.ts 文件：

import { Component } from ‘@angular/core‘;
@Component({
selector: ‘my-app‘,
template: ‘<h1>我的第一个 Angular 应用</h1>‘
})
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 字段中：

app.module.ts 文件：

import { NgModule } from ‘@angular/core‘;
import { BrowserModule } from ‘@angular/platform-browser‘;
import { AppComponent } from ‘./app.component‘;
@NgModule({
imports: [ BrowserModule ],
declarations: [ AppComponent ],
bootstrap: [ AppComponent ]
})
export class AppModule { }

第四部：启动应用

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

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

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 文件，代码如下所示：

index.html 文件：

<html>
<head>
<title>Angular 2 实例 – 菜鸟教程(runoob.com)</title>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="styles.css">
<!– 1. 载入库 –>
<!– IE 需要 polyfill –>
<script src="node_modules/core-js/client/shim.min.js"></script>
<script src="node_modules/zone.js/dist/zone.js"></script>
<script src="node_modules/reflect-metadata/Reflect.js"></script>
<script src="node_modules/systemjs/dist/system.src.js"></script>
<!– 2. 配置 SystemJS –>
<script src="systemjs.config.js"></script>
<script>
System.import(‘app’).catch(function(err){ console.error(err); });
</script>
</head>
<!– 3. 显示应用 –>
<body>
<my-app>Loading…</my-app>
</body>
</html>

这里值得注意的地方有：

  • JavaScript 库： core-js 是为老式浏览器提供的填充库， zone.js 和 reflect-metadata 库是 Angular 需要的，而 SystemJS 库是用来做模块加载的。

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

  • <my-app> 标签是应用载入的地方

    • 添加一些样式

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

    styles.css 文件：

    /* Master Styles */
    h1 {
    color: #369;
    font-family: Arial, Helvetica, sans-serif;
    font-size: 250%;
    }
    h2, h3 {
    color: #444;
    font-family: Arial, Helvetica, sans-serif;
    font-weight: lighter;
    }
    body {
    margin: 2em;
    }

    第六步：编译并运行应用程序

    打开终端窗口，输入以下命令：

    npm start

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

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

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

    源代码下载