码迷,mamicode.com
首页 > 其他好文 > 详细

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

时间:2017-10-10 17:42:51      阅读:256      评论:0      收藏:0      [点我收藏+]

标签:png   最佳实践   sudo   框架   cdn   格式   nodejs   常见   default   

使用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 显示的传递一个值,
那么,默认将是 devdevelopmentprodproduction.

# 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"
}

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

标签:png   最佳实践   sudo   框架   cdn   格式   nodejs   常见   default   

原文地址:http://www.cnblogs.com/xuepei/p/7646683.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!