Angular CLI 使用教程指南参考
Angular CLI 如今虽然能够正常使用但仍然处于测试阶段. Angular CLI 依赖 Node 4 和 NPM 3 或更高版本.node
安装
要安装Angular CLI你须要先安装node和npm,而后运行如下命令来安装最新的Angular CLI:nginx
注意:Angular CLI 须要Node 4.X 和 NPM 3.X 以上的版本支持。git
npm install -g angular-cli
在 Mac 或 Linux 平台上,你可能须要添加sudo
前缀提权进行全局安装:github
sudo npm install -g angular-cli
基本用法
你能够经过 Angular CLI 的 help
命令来获取相关的命令信息.sql
ng help
Angular CLI的命令关键字为 ng
shell
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/
. 运行以后若是你修改了程序源代码.应用将会自动重载.npm
你也能够自定义配置 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
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 |