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 |
