MacBook上Visual Studio Code开发AngularJS2 之 HelloWorld

创建我的第一个Hello World程序

前言

最近想学习一下AngularJS2，在网上找过一番资料后归纳如下，在我的笔记本上配置可行，记录供以后参考：

---

环境准备

• 安装Visual Studio Code（当前版本1.9.1） 下载地址 备份下载
• 安装Node.js（当前版本6.10.0） 下载地址 备份下载
• 教程参考http://www.runoob.com/angularjs2/angularjs2-typescript-setup.html

---

创建基础依赖

创建根目录

创建项目目录

vaio-807c175797:~ xuwen$mkdir angular2_quickstart

进入项目目录

vaio-807c175797:~ xuwen$cd angular2_quickstart

在Visual Studio Code中打开创建的目录

---

创建package.json

package.json并配置本项目所需的 npm 依赖包

{  "name": "angular-quickstart",  "version": "1.0.0",  "scripts": {    "start": "tsc && concurrently \"tsc -w\" \"lite-server\" ",    "lite": "lite-server",    "tsc": "tsc",    "tsc:w": "tsc -w"  },  "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.0.2",    "typings":"^1.3.2"  }}

使用npm install命令行更新包

vaio-807c175797:angular2_quickstart xuwen$ npm install

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

创建tsconfig.json

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

{  "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);

创建应用

创建目录

在根目录下创建app目录

vaio-807c175797:angular2_quickstart xuwen$mkdir angular2_quickstart

进入项目目录

vaio-807c175797:angular2_quickstart xuwen$cd angular2_quickstart

创建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 { }

创建app.component.ts

import { Component } from '@angular/core';@Component({  selector: 'my-app',  template: '<h1>我的第一个 Angular 应用</h1>'})export class AppComponent { }

创建main.ts

import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';import { AppModule } from './app.module';const platform = platformBrowserDynamic();platform.bootstrapModule(AppModule);

创建应用的宿主页面

创建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>

创建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;}

创建启动文件

创建launch.json

这时候Visual Studio Code会在.vscode目录下自动创建一个launch.json启动文件，修改启动文件中的program的值为${workspaceRoot}/node_modules/lite-server/bin/lite-server

创建tasks.json

编译项目

启动项目

点击调试页面的启动按钮（绿色三角符号）启动项目。

总结

1. 根据runoob网站教程做完以后发现运行停在Loading页面，怀疑是package下载的包不对，再后来仔细想想，是不是跟script这个节有关。
   教程网站上的配置
   js
"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"
},

   修改为
   js
"scripts": {
"start": "tsc && concurrently \"tsc -w\" \"lite-server\" ",
"lite": "lite-server",
"tsc": "tsc",
"tsc:w": "tsc -w"
},

2. 用Visual Studio Code调试的时候不能只创建lanuch.json，还要创建tasks.json调用TypeScript进行编译。
3. AngularJS2官网推荐使用TypeScript方式开发。
4. tsconfig.json是新版tsc提供的功能，如果你的tsc版本太舊，就會出現error TS5023: Unknown compiler option ‘p’.
   VSCode理應使用npm下載的tsc，會出錯多半是因為PATH殘留1.5以前版本TypeScript路徑所致，因新版已不需在PATH設定路徑，故請將其刪除（請刪除，不要改指向新版），詳情可參考保哥的文章。
   5.tsc有兩種！上述PATH路徑放在C:\Program Files (x86)\Microsoft SDKs\TypeScript\1.x\的是tsc.exe，C:\Users\User\AppData\Roaming\npm下的則是tsc.cmd，以JavaScript寫成，依附於node.js執行，二個是不同的東西。tsc.exe目前已經到了1.8.34，而tsc.cmd還在1.8.10，二者行為也有別。例如我就發現tsc.cmd編譯時會自動省略node_modules，故tsconfig.json不需要透過exclude排除，加了反而會有錯誤。而實測發現，NG2官網範例專案使用tsc.exe –p .方式執行，ts不會被編譯也不會有錯誤訊息，故建議將PATH中tsc.exe的路徑移除，並確認node.js的tsc元件安裝妥當。
   4、5摘自http://blog.darkthread.net/post-2016-09-16-vscode-ng2-tutorial.aspx