02.Getting Started - nkiateam/angular-tutorial GitHub Wiki

Nodejs 설치

npm 사용을 위해 Node.js 를 설치한다.

package.json 설정

프로젝트 폴더를 생성한 후 프로젝트 폴더에서 package.json 을 생성한다.

$ npm init

으로 진행하면 package.json 파일이 생성된다.

package.json 을 아래와 같이 작성한다.

{
  "name": "angular-tutorial",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "start": "tsc && concurrently \"tsc -w\" \"lite-server\" ",
    "lite": "lite-server",
    "tsc": "tsc",
    "tsc:w": "tsc -w"
  },
  "author": "NKIA",
  "license": "ISC",
  "dependencies": {
    "@angular/common": "~2.1.1",
    "@angular/compiler": "~2.1.1",
    "@angular/core": "~2.1.1",
    "@angular/forms": "~2.1.1",
    "@angular/http": "~2.1.1",
    "@angular/platform-browser": "~2.1.1",
    "@angular/platform-browser-dynamic": "~2.1.1",
    "@angular/router": "~3.1.1",
    "@angular/upgrade": "~2.1.1",
    "angular-in-memory-web-api": "~0.1.13",
    "core-js": "^2.4.1",
    "reflect-metadata": "^0.1.8",
    "rxjs": "5.0.0-beta.12",
    "systemjs": "0.19.39",
    "zone.js": "^0.6.25"
  },
  "devDependencies": {
    "@types/core-js": "^0.9.34",
    "@types/node": "^6.0.45",
    "concurrently": "^3.0.0",
    "lite-server": "^2.2.2",
    "typescript": "^2.0.3"
  }
}

npm 모듈 설치

아래 npm 명령으로 package.json 에 설정된 모듈들을 설치한다.

$ npm install

프로젝트 폴더에 node_modules 가 생성되고 node_modules 폴더에서 설치된 모듈을 확인한다.

TypeScript 컴파일 설정

typescript 컴파일을 위해 프로젝트 폴더에 tsconfig.json 을 생성한다.

{
  "compilerOptions": {
    "outDir": "build",
    "target": "es5",
    "module": "system",
    "moduleResolution": "node",
    "sourceMap": true,
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "removeComments": false,
    "noImplicitAny": false
  },
  "exclude": [
    "node_modules"
  ]
}

SystemJS 모듈 로더 설정

SystemJS 모듈 로더 설정을 위해 프로젝트 폴더에 systemjs.config.js 파일을 생성한다.

(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: './build',
      // 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',
      '@angular/upgrade': 'npm:@angular/upgrade/bundles/upgrade.umd.js',
      // other libraries
      'rxjs':                      'npm:rxjs',
      'angular-in-memory-web-api': 'npm:angular-in-memory-web-api/bundles/in-memory-web-api.umd.js'
    },
    // 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'
      }
    }
  });
})(this);

Hello World 출력 소스

"Hello World" 를 출력하기 위한 소스를 작성한다. src 폴더를 생성하고 main.ts, app.module.ts, app.component.ts 파일을 생성한다.

app.component.ts

import { Component } from '@angular/core';
@Component({
  selector: 'my-app',
  template: '<h1>Hello World</h1>'
})
export class AppComponent { }

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

main.ts

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

프로젝트 폴더에 index.html 파일을 생성한다.

index.html

<html>
  <head>
    <title>Angular Tutorial Start</title>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <link rel="stylesheet" href="styles.css">
    <!-- 1. Load libraries -->
     <!-- Polyfill(s) for older browsers -->
    <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. Configure SystemJS -->
    <script src="./systemjs.config.js"></script>
    <script>
      System.import('app').catch(function(err){ console.error(err); });
    </script>
  </head>
  <!-- 3. Display the application -->
  <body>
    <my-app>Loading...</my-app>
  </body>
</html>

결과 확인

typescript transpile과 웹서버 실행을 위해 프로젝트 폴더에서 아래와 같은 명령어를 실행한다.

typescript 를 transpile 한다.

$ npm run tsc

build 폴더가 생성되고 폴더안에 transpile 된 js 파일이 있는지 확인한다.

웹서버를 실행시킨다.

$ npm run lite

웹브라우저에서 http://localhost:3000/ 로 "Hello World" 가 출력되는 것을 확인한다.

Directory Layout

디렉토리 구조는 다음과 같다.

.
├── /build/                     # The folder for compiled output
├── /node_modules/              # 3rd-party libraries and utilities
├── /src/                       # The source code of the application
│   ├── app.component.ts        # 
│   ├── app.module.ts           #
│   └── main.ts                 #
│   
├── index.html                  # index.html
├── systemjs.config.js          # SystemJS module loader config file
├── package.json                # The list of 3rd party libraries and utilities
└── tsconfig.json               # TypeScript compiler config file