Angular CLI 使用教程指南參考
Angular CLI 現在雖然可以正常使用但仍然處於測試階段. Angular CLI 依賴 Node 4 和 NPM 3 或更高版本.
安裝
要安裝Angular CLI你需要先安裝node和npm,然後運行以下命令來安裝最新的Angular CLI:
註意:Angular CLI 需要Node 4.X 和 NPM 3.X 以上的版本支持。
npm install -g angular-cli
在 Mac 或 Linux 平臺上,你可能需要添加
sudo
前綴提權進行全局安裝:
sudo npm install -g angular-cli
基本用法
你可以通過 Angular CLI 的 help
ng help
Angular CLI的命令關鍵字為
ng
ng new
命令 | 描述 |
---|---|
ng new <project-name> [options] |
創建一個新的 Angular 項目,默認在當前所在目錄下 |
參數 | 描述 |
---|---|
--dry-run -d |
只輸出要創建的文件和執行的操作,實際上並沒有創建項目 |
--verbose -v |
輸出詳細信息 |
--skip-npm |
在項目第一次創建時不執行任何npm命令 |
--name |
指定創建項目的名稱 |
ng serve
ng new PROJECT_NAME
cd PROJECT_NAME
ng serve
將會自動在瀏覽器中打開默認地址 http://localhost:4200/
. 運行之後如果你修改了程序源代碼.應用將會自動重載.
你也可以自定義配置 IP, 端口和實時重載端口號
ng serve --host 0.0.0.0 --port 4201 --live-reload-port 49153
ng init
命令 | 描述 |
---|---|
ng init <project-name> [options] |
在當前所在目錄下初始化一個新的 Angular 項目 |
參數 | 描述 |
---|---|
--dry-run -d |
只輸出要創建的文件和執行的操作,實際上並沒有創建項目 |
--verbose -v |
輸出詳細信息 |
--skip-npm |
在項目第一次創建時不執行任何npm命令 |
--name |
指定創建項目的名稱 |
ng completion
命令 | 描述 |
---|---|
ng completion |
將自動完成功能添加到ng命令的shell中 |
ng doc
命令 | 描述 |
---|---|
ng doc <keyword> |
在瀏覽器中打開Angular文檔並搜索當前關鍵字 |
ng e2e
命令 | 描述 |
---|---|
ng e2e |
使用protractor 在當前應用中運行e2e測試 |
ng format
命令 | 描述 |
---|---|
ng format |
使用clang-format 格式化當前項目代碼 |
ng generate
命令 | 描述 |
---|---|
ng generate <type> [options] |
在項目中構建新代碼 |
ng g <type> [options] |
簡寫 |
支持的類型 | 用法 |
---|---|
Component | ng g component my-new-component |
Directive | ng g directive my-new-directive |
Pipe | ng g pipe my-new-pipe |
Service | ng g service my-new-service |
Class | ng g class my-new-class |
Interface | ng g interface my-new-interface |
Enum | ng g enum my-new-enum |
Module | ng g module my-module |
Route | ng g route my-route當前已禁用 |
構建的組件都會使用自用目錄,除非 --flat
單獨指定.
參數 | 描述 |
---|---|
--flat |
不在自用目錄內創建代碼 |
--route=<route> |
指定父路由.僅用於生成組件和路由.默認為指定的路徑. |
--skip-router-generation |
跳過生成父路由配置。只能用於路由命令。 |
--default |
指定路由應為默認路由。 |
--lazy |
指定路由是延遲的。 默認為true。 |
ng get
命令 | 描述 |
---|---|
ng get <path1, path2, ...pathN> [options] |
從Angular CLI配置獲取值 |
pathN是一個有效的JavaScript參數路徑,例如“users[1].userName”。 如果未設置該值,將顯示“undefined”。 此命令默認情況下僅在項目目錄中工作。
參數 | 描述 |
---|---|
--global |
返回全局配置值,而不是本地配置值(如果都設置). 此選項還可以使命令在項目目錄外工作 |
ng set
命令 | 描述 |
---|---|
ng get <path1=value1, path2=value2, ...pathN=valueN> [options] |
在Angular CLI配置中設置值 |
默認情況下,如果在項目內部運行,則設置項目配置中的值,如果不在項目內部,則失敗。 pathN參數是一個有效的JavaScript路徑,如“users [1] .userName”。 該值將被強制轉換為正確的類型,或者如果類型無法強制,則會拋出錯誤。
參數 | 描述 |
---|---|
--global |
設置全局配置值,而不是本地配置值。 這也使ng set 可以在項目之外工作。 |
ng build
構建工件將存儲在/dist
目錄中。
ng build可以指定構建目標(--target = production或--target = development)和要與該構建一起使用的環境文件(--environment = dev或--environment = prod)。 默認情況下,使用開發構建目標和環境。
# 這是生產構建
ng build --target=production --environment=prod
ng build --prod --env=prod
ng build --prod
# 這是開發構建
ng build --target=development --environment=dev
ng build --dev --e=dev
ng build --dev
ng build
ng github-pages:deploy
命令 | 描述 |
---|---|
ng github-pages:deploy [options] |
構建生產應用程序,設置GitHub存儲庫,然後發布應用程序。 |
參數 | 描述 |
---|---|
--message=<message> |
構建並提交信息.默認為 "new gh-pages version" |
--environment=<env> |
angular 環境構建。 默認為“production” |
--branch=<branch-name> |
推送頁面的git分支。 默認為“gh-branch” |
--skip-build |
在發布之前跳過構建項目 |
--gh-token=<token> |
用於部署的API令牌,必須. |
--gh-username=<username> |
使用的Github用戶名,必須. |
ng lint
命令 | 描述 |
---|---|
ng lint |
在項目上運行codelyzer linter |
ng test
命令 | 描述 |
---|---|
ng test [options] |
使用 karma 運行單元測試 |
參數 | 描述 |
---|---|
--watch |
繼續運行測試. 默認為true |
--browsers , --colors , --reporters , --port , --log-level |
這些參數直接傳遞給karma |
ng version
命令 | 描述 |
---|---|
ng version |
輸出cli版本, node 版本和操作系統信息 |
參數 | 描述 |
---|---|
--watch |
繼續運行測試. 默認為true |
Angular CLI 使用教程指南參考