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 [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 [options]	在当前所在目录下初始化一个新的 Angular 项目

参数	描述
–dry-run -d	只输出要创建的文件和执行的操作，实际上并没有创建项目
–verbose -v	输出详细信息
–skip-npm	在项目第一次创建时不执行任何npm命令
–name	指定创建项目的名称

ng completion

命令	描述
ng completion	将自动完成功能添加到ng命令的shell中

ng doc

命令	描述
ng doc	在浏览器中打开Angular文档并搜索当前关键字

ng e2e

命令	描述
ng e2e	使用protractor在当前应用中运行e2e测试

ng format

命令	描述
ng format	使用clang-format格式化当前项目代码

ng generate

命令	描述
ng generate [options]	在项目中构建新代码
ng g [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=	指定父路由.仅用于生成组件和路由.默认为指定的路径.
–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