AngularCLI介绍及配置文件主要参数含义解析

使用Angular CLI可以快速，简单的搭建一个angular2或angular4项目，是只要掌握几行命令就能构建出前端架构的最佳实践，它本质也是使用了webpack来编译，打包，压缩等构建的事情，适合想用webpack的特性又不想学习webpack那些复杂的配置的开发者；

一、AngularCLI主要特性

1 Angular CLI 可以快速搭建框架，创建module，service，class，directive等；

2 具有webpack的功能，代码分割（code splitting），按需加载；

3 代码打包压缩；

4 模块测试，端到端测试；

5 热部署，有改动立即重新编译，不用刷新浏览器；而且速度很快

6 有开发环境，测试环境，生产环境的配置，不用自己操心；

7 sass，less的预编译Angular CLI都会自动识别后缀来编译；

8 typescript的配置，Angular CLI在创建应用时都可以自己配置；

9 在创建好的工程也可以做一些个性化的配置，webpack的具体配置还不支持，未来可能会增加；

10 Angular CLI创建的工程结构是最佳实践，生产可用；

开始搭建，基础工具的安装：

你需要安装NodeJS 5.0以上版本,NPM 3.0以上版本；

安装 Angular CLI

windows： npm install -g angular-cli     //全局安装

macOS: sudo npm install -g angular-cli

创建Angular2工程

ng new new_project       //new_project是你的项目名；

 

常用命令  ng generate (或 ng g)命令来创建Angular各种组件

范围	命令	作用
new	ng new new_project	初始化新项目
Component	ng g component my-new-component	新建一个组件
Module	ng g module my-module	新建一个模块
Directive	ng g directive my-new directive	新建一个指令
Pipe	ng g pipe my-new-pipe	新建一个管道
Service	ng g service my-new-srevice	新建一个服务
Class	ng g class my-new-class	新建一个类
Interface	ng g interface my-new-interface	新建一个接口
Enum	ng g enum my-new enum	新建一个枚举

 

 

测试及检测

 

范围	命令	作用
e2e	ng e2e	执行端到端测试-自己写测试用例
test	ng test	执行单元测试
lint	ng lint	调用tslint跑整个项目，可以收获一堆警告和错误，-force, -fix -format可以帮助格式和修复部分问题

 

 

 

 

 

 

 

启动

ng serve   :   启动脚手架服务，默认端口是4200,

 

打包编译 

ng build : 开发模式打包  ，调用的环境文件是 /src/environments/environments.ts;  编译出来的结果将被存储在dist/目录

ng build --prod : 以前调用aot打包还需要带上--aot, 从beta31开始， --prod模式下自动调用aot打包，调用的环境文件是/src/environments/environments.prod.ts

ng build 可以指定两种编译目标： (--target=production or --target=development) 和 (--environment=dev or --environment=prod)，一个环境文件跟后者一起使用.
默认情况下, 编译开发目标和环境均被使用.

在angular-cli.json中的以下配置可以决定那个环境配置文件将被使用：

"environments": {
  "source": "environments/environment.ts",
  "dev": "environments/environment.ts",
  "prod": "environments/environment.prod.ts"
}

这些选项同样适用于命令行， 如果你没有为 environment 显示的传递一个值,
那么，默认将是 dev 对development 、prod 对production.

# these are equivalent
ng build --target=production --environment=prod
ng build --prod --env=prod
ng build --prod
# and so are these
ng build --target=development --environment=dev
ng build --dev --e=dev
ng build --dev
ng build

生成的目录树小解释

 

angular-cli 的核心配置文件.angular-cli.json常见配置参数解释

{

"project": {
    "name": "ng-admin", //项目名称
    "ejected": false // 标记该应用是否已经执行过eject命令把webpack配置释放出来
  },

"apps": [
    {
      "root": "src", // 源码根目录
      "outDir": "dist", // 编译后的输出目录，默认是dist/
      "assets": [ // 记录资源文件夹，构建时复制到`outDir`指定的目录
        "assets",
        "favicon.ico"
      ],
      "index": "index.html", // 指定首页文件，默认值是"index.html"
      "main": "main.ts", // 指定应用的入门文件
      "polyfills": "polyfills.ts", // 指定polyfill文件
      "test": "test.ts", // 指定测试入门文件
      "tsconfig": "tsconfig.app.json", // 指定tsconfig文件
      "testTsconfig": "tsconfig.spec.json", // 指定TypeScript单测脚本的tsconfig文件
      "tsconfig":"tsconfig.app.json",

      "prefix": "app", // 使用`ng generate`命令时，自动为selector元数据的值添加的前缀名
      "deployUrl": "//cdn.com.cn", // 指定站点的部署地址，该值最终会赋给webpack的output.publicPath，常用于CDN部署
      "styles": [ // 引入全局样式，构建时会打包进来，常用于第三方库引入的样式
        "styles.css"
      ],
      "scripts": [ // 引入全局脚本，构建时会打包进来，常用语第三方库引入的脚本
      ],
      "environmentSource": "environments/environment.ts", // 基础环境配置
      "environments": { // 子环境配置文件
        "dev": "environments/environment.ts",
        "prod": "environments/environment.prod.ts"
      }
    }
  ],

"e2e": {
    "protractor": {
      "config": "./protractor.conf.js"
    }
  },
  "lint": [
    {
      "project": "src/tsconfig.app.json"
    },
    {
      "project": "src/tsconfig.spec.json"
    },
    {
      "project": "e2e/tsconfig.e2e.json"
    }
  ],
  "test": {
    "karma": {
      "config": "./karma.conf.js"
    }
  },

"defaults": { // 执行`ng generate`命令时的一些默认值
    "styleExt": "scss", // 默认生成的样式文件后缀名
    "component": {
      "flat": false, // 生成组件时是否新建文件夹包装组件文件，默认为false（即新建文件夹）
      "spec": true, // 是否生成spec文件，默认为true
      "inlineStyle": false, // 新建时是否使用内联样式，默认为false
      "inlineTemplate": false, // 新建时是否使用内联模板，默认为false
      "viewEncapsulation": "Emulated", // 指定生成的组件的元数据viewEncapsulation的默认值
      "changeDetection": "OnPush", // 指定生成的组件的元数据changeDetection的默认值
    }
  }

}

二. 常用命令的通用关键参数解释
1.ng serve --host (self)
指定本地Server绑定的域名，默认值：localhost.如果希望使用self来访问你的站点，须加入以上参数
2.ng serve --hmr
注意开启之后，只是在angular-cli里的webpack添加必要的扩展，等价于webpack-dev-server --hot，还需要在应用代码里处理hmr逻辑，如可在main.ts里添加：

if(module.hot) {
  module.hot.accept();
}

3.ng serve --aot
开启aot
4.ng serve --proxy-config proxy.conf.json
指定后台转发地址，即nginx的proxy_pass代理功能。开发时为避免ajax跨域，需要指定后台接口的转发地址。
proxy.config.json文件示例如下：

{
  "/api": { // 匹配前缀
    "target": "http://localhost:3000", // 转发地址
    "secure": false
  }
}

5.--base-href
指定站点的起始路径，如果你希望你的站点根路径为www.abc.com/mypath/，需要这样设置：ng build --base-href /mypath/
6.--target
指定构建的目标，默认值是development，如果指定为production，构建时会加入treeshaking、代码压缩混淆等。下面两条等价：

ng build --target=production
ng build --prod 

7.--environment
指定应用执行环境。CLI会根据指定的值加载对应的环境配置文件。下面两句等价：

ng build --environment=prod
ng build --env=prod
构建时会加载angular-cli.json指定的环境配置文件：

"environments": {
  "dev": "environments/environment.ts",
  "prod": "environments/environment.prod.ts"
}