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