angular-cli 文檔

Angular/angular-cli 

原文來自：https://github.com/angular/angular-cli

 

Angular/angular-cli 

原文來自：https://github.com/angular/angular-cli

cli應用於基於ember-cli項目的Angular應用

 

 

備註:

若是你正從測試版或rc版本更新，請查看咱們的1.0更新指南。

若是你但願合做，請查閱咱們的合做事項清單。

在提交新問題以前，請注意查看那些被標註’常見問題清單’的問題，或許你能夠找到你想要的問題答案。

 

 

前提說明：

cli和生成的項目存在依賴關係，要求node的版本在6.9.0+，npm 3.0+。

 

 

目錄：

#安裝

#用法

#生成一個新項目

#生成控制器、指令、管道和服務

#更新angular-cli

#基於angular-cli的開發說明

#文檔

#證書

 

 

安裝：

在你安裝以前：請閱讀前提說明

npm install -g @angular/cli

 

 

用法：

ng help

經過開發服務器生成一個angular項目

      ng new PROJECT-NAME

      cd PROJECT-NAME

      ng serve

      打開本地地址http://localhost:4200/。當你修改任意資源文件時，頁面將自動重載。

      你也能夠經過開發服務器運行如下的命令行進行本身配置http host以及端口號：

      ng serve —host 0.0.0.0 —port 4201

生成控制器、指令、管道和服務

      你可使用命令行 ng generate(或簡寫：ng g)，生成angular的控制器

       Ng generate component my-new-component

       Ng g component my-new-component  # 簡寫

       # 控制器支持用相對路徑生成

       # 若是在src/app/feature，能夠運行如下命令行生成

          Ng g component new-cmp

       # 你所要生成的控制器將出如今目錄 src/app/feature/new-cmp 下

       # 可是若是你運行如下命令行

          ng g component  ../newer-cmp

       # 你的控制器將會生成在上級目錄，即：src/app/newer-cmp

       # 若是你的當前目錄是 src/app 你能夠運行：

          ng g component feature/new-cmp

       # 控制器將會生成在 src/app/feature/new-cmp 路徑下

你能夠在如下的表格中找到全部可能須要的ng命令

 

Scaffold	Usage
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
Guard	ng g guard my-new-guard
Interface	ng g interface my-new-interface
Enum	ng g enum my-new-enum
Module	ng g module my-module

 

Angular-cli會在app.module.ts中給控制器、指令及管道自動添加引用，若是你須要給另外的自定義模塊添加引用，按照如下步驟：

1、ng g module new-module

2、call ng g component new-module/new-component

上面的命令將會根據你新建立的模塊增長新的控制器、指令或者管道。

更新angular—cli

   若是你正在使用angular-cli 1.0.0-beta.28 或者更低版本，你須要先卸載angular-cli安裝包

   npm uninstall -g angular-cli

   npm uninstall —save-dev angular-cli

爲了更新angular cli到新版本，你必須更新全局的安裝包和你項目本地的安裝包

全局安裝包：

npm uninstall -g @angular/cli

npm cache clean

# 若是npm版本高於version5，須要使用’npm cache verify’ 來避免報錯（或者避免使用 —-force）

npm install -g @angular/cli@latest

本地項目安裝包：

rm -rf node_modules dist # 在window的命令控制符中使用 rmdir /S/Q node_modules dist，在Windows PowerShell中使用rm -f -fo node_modules,dist

npm install —-save-dev @angular/cli@latest

npm install

若是你正從beta或者RC版本更新到1.0，請查閱咱們的1.0更新指南文檔。

在github的版本標籤上，你會發現更多關於版本間改變的詳細內容。

 

 

關於在Angular Cli上進行開發的一些規範

1、使用master分支

   git clone https://github.com/angular/angular-cli.git

   cd angular-cli

   npm link

   npm link 命令的做用和npm install -g是同樣的，只是link不會從repo下載安裝包，僅將克隆的angular-cli/ 文件目錄變成全局的安裝包。此外，這個目錄的倉庫會生成幾個安裝包，咱們會使用特別的邏輯將全部的安裝包添加到開發設置上。

任何在angular-cli目錄文件上的改動都會當即影響到全局的@angular／cli安裝包，你能夠快速檢測到你在cli項目上的任何改動。

如今能夠經過如下命令行使用@angular/cli：

ng new foo

cd foo

npm link @angular/cli

ng serve

npm link @angular/cli將全局的@angular/cli包鏈到本地做用域。

也能夠直接用 ng new foo —link-cli 自動級聯到@angular/cli包。

可閱讀官方的npm-link文檔和npm-link cheatsheet獲取更多信息。

想運行測試套件，可使用node的tests/run_e2e.js命令。

接收一個文件名才能運行該命令（如：node tests/run_e2e.js tests/e2e/tests/build/dev-build.ts）

做爲測試程序的部分，全部的的包都要構建和連接。在測試完成後，須要從新運行npm link來從新連接開發環境的AAngular CLI。