Angular CLI 安裝和使用

一、 背景介紹:

兩個概念:

  1. 關于Angular版本,Angular官方已經統一命名Angular 1.x統稱為Angular JSAngular 2.x及以上統稱Angular
  2. CLI是Command Line Interface的簡寫,是一種命令行接口,實現自動化開發流程,比如:ionic clivue cli等;它可以創建項目、添加文件以及執行一大堆開發任務,比如測試、打包和發布。

二、安裝Angular CLI

1. 首先確認安裝了node.jsnpm

// 顯示當前node和npm版本
$ node -v
$ npm -v
// node 版本高于6.9.3  npm版本高于3.0.0

2. 全局安裝typescript(可選)

$ npm install -g typescript 
// 新建項目的時候會自動安裝typescript(非全局)所以這里也可以不用安裝。

3. 安裝Angular CLI

$ npm install -g @angular/cli

經過不算漫長的等待,你的Angular CLI就裝好了。確認一下:

$ ng v

// 出現下面畫面說明安裝成功,如果不成功你可能需要uninstall一下,再重新來過
$ ng v
    _                      _                 ____ _     ___
   / \   _ __   __ _ _   _| | __ _ _ __     / ___| |   |_ _|
  / △ \ | '_ \ / _` | | | | |/ _` | '__|   | |   | |    | |
 / ___ \| | | | (_| | |_| | | (_| | |      | |___| |___ | |
/_/   \_\_| |_|\__, |\__,_|_|\__,_|_|       \____|_____|___|
               |___/
@angular/cli: 1.1.1
node: 7.10.0
os: darwin x64

期間可能會失敗(先看錯誤信息),可能由于node-sass這個包被墻了,所以解決辦法有兩個:要么用梯子,要么用淘寶鏡像。

// 淘寶鏡像解藥
SASS_BINARY_SITE=https://npm.taobao.org/mirrors/node-sass/ npm install node-sass

這里可以參考

當然你也可以所有的東西都從淘寶源來安裝,整個過程會快不少:

// 安裝cnpm
npm install -g cnpm --registry=https://registry.npm.taobao.org

三、新建Angular項目

1. 新建Angular項目:

$ ng new my-app

這里要等很久啊,大概要下載141M東西。
如果你已經建好了項目文件夾就可以使用ng init my-app來新建項目,ng initng new的區別是ng new會幫我們創建一個和項目名稱相同的文件夾。

趁著它在下載,來看一下運行ng new之后Angular cli已經幫我們干了什么:

$ ng new helloKeriy
installing ng
  create .editorconfig
  create README.md
  create src/app/app.component.css      // 使用HTML模板、CSS樣式和單元測試定義AppComponent組件。 它是根組件,隨著應用的成長它會成為一棵組件樹的根節點。
  create src/app/app.component.html
  create src/app/app.component.spec.ts
  create src/app/app.component.ts       // 定義AppModule,這個根模塊會告訴Angular如何組裝該應用
  create src/app/app.module.ts
  create src/assets/.gitkeep            // 這個文件夾下你可以放圖片等任何東西,在構建應用時,它們全都會拷貝到發布包中。
  create src/environments/environment.prod.ts
  create src/environments/environment.ts
  create src/favicon.ico        // 每個網站都希望自己在書簽欄中能好看一點。 請把它換成你自己的圖標。
  create src/index.html         // 宿主頁面
  create src/main.ts
  create src/polyfills.ts
  create src/styles.css         // 公共樣式
  create src/test.ts            // 這是單元測試的主要入口點
  create src/tsconfig.app.json
  create src/tsconfig.spec.json
  create src/typings.d.ts
  create .angular-cli.json      // Anguar 編譯依賴
  create e2e/app.e2e-spec.ts    // e2e 端對端測試目錄
  create e2e/app.po.ts
  create e2e/tsconfig.e2e.json
  create .gitignore
  create karma.conf.js
  create package.json           // Angular 的依賴包
  create protractor.conf.js
  create tsconfig.json          // TypeScript 編譯器的參數
  create tslint.json
Successfully initialized git.
Installing packages for tooling via npm.
Installed packages for tooling via npm.
Project 'helloKeriy' successfully created.

這里也可以使用淘寶源了安裝:

$ ng new helloKeriy --skip-install  // 先跳過npm安裝
$ cd helloKeriy
$ cnpm install                      // 使用淘寶源安裝

那么,這時候Angular cli幫你干了以下這么多事情:

  • 創建 helloKeriy 目錄
  • 應用程序相關的源文件和目錄將會被創建
  • 應用程序的所有依賴 (package.json中配置的依賴項) 將會被自動安裝
  • 自動配置項目中的 TypeScript 開發環境
  • 自動配置 Karma 單元測試環境
  • 自動配置 Protractor (end-to-end) 測試環境
  • 創建 environment 相關的文件并初始化為默認的設置
    2. 成果展示
    安裝完成之后就可以啟動項目了:
cd helloKeriy
ng serve -open

ng serve命令會啟動開發服務器,監聽文件變化,并在修改這些文件時重新構建此應用。
使用--open(或-o)參數可以自動打開瀏覽器并訪問http://localhost:4200/
接下來你將看到:

surprise

上面展示的是我們的根組件,我們科室適當修改其中的一些信息,顯示自己喜歡的內容。
ng serve命令提供了很多參數,可以適當參考。
以下參數僅供參考:

  • --dry-run: boolean, 默認為 false, 若設置 dry-run 則不會創建任何文件
  • --verbose: boolean, 默認為 false
  • --link-cli: boolean, 默認為 false, 自動鏈接到 @angular/cli
  • --skip-install: boolean, 默認為 false, 表示跳過 npm install
  • --skip-git: boolean, 默認為 false, 表示該目錄不初始化為 git 倉庫
  • --skip-tests: boolean, 默認為 false, 表示不創建 tests 相關文件
  • --skip-commit: boolean, 默認為 false, 表示不進行初始提交
  • --directory: string, 用于設置創建的目錄名,默認與應用程序的同名
  • --source-dir: string, 默認為 'src', 用于設置源文件目錄的名稱
  • --style: string, 默認為 'css', 用于設置選用的樣式語法 ('css', 'less' or 'scss')
  • --prefix: string, 默認為 'app', 用于設置創建新組件時,組件選擇器使用的前綴
  • --mobile: boolean, 默認為 false,表示是否生成 Progressive Web App 應用程序
  • --routing: boolean, 默認為 false, 表示新增帶有路由信息的模塊,并添加到根模塊中
  • --inline-style: boolean, 默認為 false, 表示當創建新的應用程序時,使用內聯樣式
  • --inline-template: boolean, 默認為 false, 表示當創建新的應用程序時,使用內聯模板

四、Angular CLI簡單使用

1. 新建組件

$ ng generate component great-angular
installing component
  create src/app/great-angular/great-angular.component.css
  create src/app/great-angular/great-angular.component.html
  create src/app/great-angular/great-angular.component.spec.ts
  create src/app/great-angular/great-angular.component.ts
  update src/app/app.module.ts

如你所見,Angular cli幫我們干了如下事情:

src/app/great-angular 目錄被創建
great-angular 目錄下會生成以下四個文件:
CSS 樣式文件,用于設置組件的樣式
HTML 模板文件,用于設置組件的模板
TypeScript 文件,里面包含一個 GreatAngular 組件類和組件的元信息
Spec 文件,包含組件相關的測試用例
GreatAngular 組件會被自動地添加到最近模塊 @NgModule 裝飾器的 declarations 屬性中。

2. 其他命令

Angualr CLI提供了許多常用命令供我們選擇:

ng generate class my-new-class              // 新建 class
ng generate component my-new-component      // 新建組件
ng generate directive my-new-directive      // 新建指令
ng generate enum my-new-enum                // 新建枚舉
ng generate module my-new-module            // 新建模塊
ng generate pipe my-new-pipe                // 新建管道
ng generate service my-new-service          // 新建服務

當然選擇。。簡寫:

ng g cl my-new-class        // 新建 class
ng g c my-new-component     // 新建組件
ng g d my-new-directive     // 新建指令
ng g e my-new-enum          // 新建枚舉
ng g m my-new-module        // 新建模塊
ng g p my-new-pipe          // 新建管道
ng g s my-new-service       // 新建服務

CLI git文檔

3. 單元測試
Angular默認幫我們集成了``karma`測試框架,我們只需要:

$ ng test

4. 端到端測試

$ ng e2e

關于Angular測試部分詳細可以參考官方文檔
5. 構建應用程序

$ ng built

其中過程應該是這樣的:
Angular CLI.angular-cli.json 文件中加載配置信息
Angular CLI 運行 Webpack 打包項目相關的 JavaScriptCSS 等文件
打包后的資源,將被輸出到配置文件中 outDir 所指定的目錄,默認是輸出到 dist 目錄。

這只是一個初級的文檔,強烈建議請參考Angular CLI 終極指南

7. 參考文獻

官方文檔--Angular CLI快速起步
官方文檔--部署
Angular CLI 終極指南

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,333評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,491評論 3 416
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,263評論 0 374
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,946評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,708評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,186評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,255評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,409評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,939評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,774評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,976評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,518評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,209評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,641評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,872評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,650評論 3 391
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,958評論 2 373

推薦閱讀更多精彩內容