全端開發人員天梯

本篇會簡單介紹一些常用的Angular CLI語法，如需要完整的說明可參考官方文件。

安裝Angular CLI並產生Angular2專案

安裝Angular CLI動作非常簡單，前一篇文章也介紹過了，基本上只需要確認node的版本是4.x.x以上，npm須為3.x.x以上即可透過以下指令安裝Angular CLI

npm install -g angular-cli

接下來就可以使用 ng 這個指令來執行這種開發Angular2專案需要的動作啦。

首先我們先用 ng --help 來看看所有可用的指令：

可以看到洋洋灑灑一大堆的指令說明，也可以用 ng --help [command]看比較"精簡"一點的說明。例如我想知道generate這個指令的用法，就輸入 ng --help generate，就可以單純看某個指令的用法囉。

接下來我們就稍微說明一些常用的Angular CLI指令吧！

ng new

安裝好Angular CLI以後當然是立刻使用 ng new [專案名稱] 來產生一個Angular2專案啦。

這個指令會依我們輸入的專案名稱產生一個專案目錄，同時幫我們把所有預設需要的相關套件都紀錄在package.json，然後將所有需要的套件都下載下來；除此之外也會幫我們產生一個Angular2專案最基本需要的程式碼、還有簡單的測試案例、測試環境設定、編輯器環境設定(如果編輯器支援的話)、預設的與法規範設定檔(tslint.json)等等；想想看這些步驟如果要自己一個一個處理要花多少時間，還要擔心人腦智慧出錯的可能性，但透過ng new，只需要下指令並稍等一下就可以啦！

關於ng new產生的專案目錄，在下一篇文章我們會做一個比較詳細的介紹。

ng generate(ng g)

ng generate可以說是整個Angular CLI裡面最常用到的指令，它的功能就是用來產生Angular2的元件(component)、服務(service)等等的程式雛形，由於generate指令非常常用，但generate字母又不少，因此我們也可很簡單的使用 ng g來執行產生動作，目前ng g可產生以下類型的程式

例如需要產生一個Angular2的元件，可以使用 ng g component，來產生一個component所需要的檔案，另外我們也可以在把剛剛的指令簡化成ng g c。只需要短短幾個字，就可以產生許多的程式碼囉！

根據官方的Angular CLI原始碼，我們也可以看到不同程式碼雛形的指令簡化

不過很可惜，由於Angular2的route在RC階段一直有改變，雖然正式版已經release了，但目前Angular CLI還不支援route的產生，因此使用ng g r來產生route的話，會出現以下錯誤訊息，期待某天可以正常產生囉！

使用ng generate產生的物件會依照預設值放在特定目錄下，若需要指定目錄也可以透過相對路徑的表示方式來改變目錄，例如ng g c todo-items預設檔案會產生在/src/app/todo-list下面，我們可以改用ng g c todo-list\todo-items來將檔案改為產生在/src/app/todo-item/todo-list下面。不過需要稍微注意兩點

1. 若要建立在額外目錄下，該目錄必須存在才可建立，若目錄不存在請先把目錄建立起來

2. 產生component時會在/src/app/app.module.ts檔內進行注入動作，但目前會發生import時路徑的斜線反了的問題導致錯誤，因此必須手動修改app.module.ts的內容，麻煩的是每次ng g c產生component時同樣的問題又會繼續發生，希望之後的版本會修正囉。(寫這篇文章時Angular CLI版本為1.0.0-beta.15)

ng destroy(ng d)

ng destroy是用來移除ng generate所產生的檔案的，不過只是進行把檔案刪除的動作而已，對於用到產生的物件，還是必須手動在程式碼中清除。

例如我們使用ng g c todo-item建立一個todi-item的component，但後悔了，就可以使用 ng d component todo-item (目前不支援 ng d c這種寫法)來移除檔案。

ng build

當Angular2的程式開發完成，需要部屬到別台機器上時，我們可以使用ng build來打包所有的程式碼，這個步驟會將所有TypeScript的檔案轉譯成JavaScript，同時也會使用Tree Shaking的技術只留下開發時有使用到的相依物件，並將所有程式分類打包，最後產出到專案下的dist目錄，我們就可以將這個目錄部屬到測試或正式環境上執行。另外若是要上線的系統了，還可以使用ng build --prod再將產出的JavaScript做最小化壓縮的動作，以節省下載程式碼的等待時間。如果我們希望在程式有修改時就自動進行build的動作，也可以使用ng build -w來偵測變更並自動執行build。

Angular CLI使用webpack作為打包程式的工具，有趣的是使用ng new建立的專案找不到webpack.js之類的檔案，這也算是習慣取代配置的好處之一，對於打包程式這件事情我們不用花太多心思，Angular CLI都已經內建好了，只要我們程式撰寫配合通用的習慣，剩下的直接使用別人寫好的範本來跑就好啦！如果想看看Angular CLI預設的webpack程式，可以參考專案目錄下node_modules\angular-cli\tasks下面的檔案。除此之外Angular2官方的webpack介紹也說得非常仔細，建議有時間可以去看看。

ng serve

在程式開發階段，我們經常需要打開瀏覽器來觀看程式執行的結果，使用ng serve可以自動幫你把程式打包，並開啟一個live reload的http server，如此一來當我們程式有修改時，就會自動幫你重新build一次，同時如果有用瀏覽器打開目前的程式時，也會通知自動重整，就不用一直按F5重新整理啦！

ng lint

使用Angular CLI建立的專案會預設加入一個tslint.json檔案，用來設定TypeScript撰寫風格的相關限制，我們可以自行在tslint.json裡面修改來調整符合團隊開發的規範，若要檢查專案中的程式碼是否符合規範，可以使用 ng lint 來檢查，看看那些檔案中有不符合規則的程式存在。

ng test & ng e2e

ng test和ng e2e兩個指令都是用來執行測試程式的，不同的是ng test是屬於unit test的部分，會執行src/app下面所有的測試程式碼，使用的測試套件為karma與jasmine。

而ng e2e則是用來執行end to end測試，會執行/e2e下面的測試程式，使用的測試套件為karma與protractor。

如果已經有寫過JavaScript的人對於這些測試程式應該不會太陌生，未來有機會寫到Angular2的測試時，在多介紹一些。

單元回顧

本篇文章介紹了Angular CLI的一些常用指令，日後在使用Angular CLI時應該能更加清楚指令的用途與原理，透過Angular CLI可以幫助我們在開發的時候節省很多配置時間。

官方的文件還有一些小技巧，有興趣的朋友可以去參考看看囉。