发表于: 2017-06-22 20:12:12
4 1052
一、 基本概念:
- 1. 关于
Angular
版本,Angular
官方已经统一命名Angular 1.x
同一为Angular JS
;Angular 2.x
及以上统称Angular
; 2. CLI
是Command Line Interface的简写,是一种命令行接口,实现自动化开发流程,比如:ionic cli
、vue cli
等;它可以创建项目、添加文件以及执行一大堆开发任务,比如测试、打包和发布。
二、安装Angular CLI
1. 首先确认安装了node.js
和npm
// 显示当前node和npm版本$ node -v$ npm -v// node 版本高于6.9.3 npm版本高于3.0.0
2. 全局安装typescript
(可选)
$ npm install -g typescript// 新建项目的时候会自动安装typescript(非全局)所以这里也可以不用安装。
3. 安装Angular CLI
$ npm install -g @angular/cli
经过不算漫长的等待,你的Angular CLI
就装好了。确认一下:
$ ng v// 出现下面画面说明安装成功,如果不成功你可能需要uninstall一下,再重新来过$ ng v_ _ ____ _ ___/ \ _ __ __ _ _ _| | __ _ _ __ / ___| | |_ _|/ △ \ | '_ \ / _` | | | | |/ _` | '__| | | | | | |/ ___ \| | | | (_| | |_| | | (_| | | | |___| |___ | |/_/ \_\_| |_|\__, |\__,_|_|\__,_|_| \____|_____|___||___/@angular/cli: 1.1.1node: 7.10.0os: darwin x64
期间可能会失败(先看错误信息),可能由于node-sass
这个包被墙了,所以解决办法有两个:要么用梯子,要么用淘宝镜像。
// 淘宝镜像解药SASS_BINARY_SITE=https://npm.taobao.org/mirrors/node-sass/ npm install node-sass
当然你也可以所有的东西都从淘宝源来安装,整个过程会快不少:
npm install -g cnpm --registry=https://registry.taobao.org
三、新建Angular项目
1. 新建Angular
项目:
$ ng new my-app
这里要等很久啊,大概要下载141M东西。
如果你已经建好了项目文件夹就可以使用ng init my-app
来新建项目,ng init
和ng new
的区别是ng new
会帮我们创建一个和项目名称相同的文件夹。
趁着它在下载,来看一下运行ng new
之后Angular cli
已经帮我们干了什么:
$ ng new helloKeriyinstalling ngcreate .editorconfigcreate README.mdcreate src/app/app.component.css // 使用HTML模板、CSS样式和单元测试定义AppComponent组件。 它是根组件,随着应用的成长它会成为一棵组件树的根节点。create src/app/app.component.htmlcreate src/app/app.component.spec.tscreate src/app/app.component.ts // 定义AppModule,这个根模块会告诉Angular如何组装该应用create src/app/app.module.tscreate src/assets/.gitkeep // 这个文件夹下你可以放图片等任何东西,在构建应用时,它们全都会拷贝到发布包中。create src/environments/environment.prod.tscreate src/environments/environment.tscreate src/favicon.ico // 每个网站都希望自己在书签栏中能好看一点。 请把它换成你自己的图标。create src/index.html // 宿主页面create src/main.tscreate src/polyfills.tscreate src/styles.css // 公共样式create src/test.ts // 这是单元测试的主要入口点create src/tsconfig.app.jsoncreate src/tsconfig.spec.jsoncreate src/typings.d.tscreate .angular-cli.json // Anguar 编译依赖create e2e/app.e2e-spec.ts // e2e 端对端测试目录create e2e/app.po.tscreate e2e/tsconfig.e2e.jsoncreate .gitignorecreate karma.conf.jscreate package.json // Angular 的依赖包create protractor.conf.jscreate tsconfig.json // TypeScript 编译器的参数create tslint.jsonSuccessfully initialized git.Installing packages for tooling via npm.Installed packages for tooling via npm.Project 'helloKeriy' successfully created.
这里也可以使用淘宝源了安装:
$ ng new helloKeriy --skip-install // 先跳过npm安装$ cd helloKeriy$ cnpm install // 使用淘宝源安装
那么,这时候Angular cli
帮你干了以下这么多事情:
- 创建
helloKeriy
目录 - 应用程序相关的源文件和目录将会被创建
- 应用程序的所有依赖 (
package.json
中配置的依赖项) 将会被自动安装 - 自动配置项目中的
TypeScript
开发环境 - 自动配置
Karma
单元测试环境 - 自动配置
Protractor
(end-to-end) 测试环境 - 创建
environment
相关的文件并初始化为默认的设置
2. 成果展示
安装完成之后就可以启动项目了:
cd helloKeriyng serve -open
ng serve
命令会启动开发服务器,监听文件变化,并在修改这些文件时重新构建此应用。
使用--open
(或-o
)参数可以自动打开浏览器并访问http://localhost:4200/
。
接下来你将看到:
上面展示的是我们的根组件,我们科室适当修改其中的一些信息,显示自己喜欢的内容。ng serve
命令提供了很多参数,可以适当参考。
以下参数仅供参考:
--dry-run: boolean
, 默认为false
, 若设置dry-run
则不会创建任何文件--verbose: boolean
, 默认为false
--link-cli: boolean
, 默认为 false, 自动链接到@angular/cli
包--skip-install: boolean
, 默认为false
, 表示跳过npm install
--skip-git: boolean
, 默认为false
, 表示该目录不初始化为 git 仓库--skip-tests: boolean
, 默认为false
, 表示不创建tests
相关文件--skip-commit: boolean
, 默认为false
, 表示不进行初始提交--directory: string
, 用于设置创建的目录名,默认与应用程序的同名--source-dir: string
, 默认为'src'
, 用于设置源文件目录的名称--style: string
, 默认为'css'
, 用于设置选用的样式语法 ('css'
,'less'
or'scss'
)--prefix: string
, 默认为'app'
, 用于设置创建新组件时,组件选择器使用的前缀--mobile: boolean
, 默认为false
,表示是否生成 Progressive Web App 应用程序--routing: boolean
, 默认为false
, 表示新增带有路由信息的模块,并添加到根模块中--inline-style: boolean
, 默认为false
, 表示当创建新的应用程序时,使用内联样式--inline-template: boolean
, 默认为false
, 表示当创建新的应用程序时,使用内联模板
四、Angular CLI简单使用
1. 新建组件
$ ng generate component great-angularinstalling componentcreate src/app/great-angular/great-angular.component.csscreate src/app/great-angular/great-angular.component.htmlcreate src/app/great-angular/great-angular.component.spec.tscreate src/app/great-angular/great-angular.component.tsupdate src/app/app.module.ts
如你所见,Angular cli
帮我们干了如下事情:
src/app/great-angular
目录被创建great-angular
目录下会生成以下四个文件:CSS
样式文件,用于设置组件的样式HTML
模板文件,用于设置组件的模板TypeScript
文件,里面包含一个 GreatAngular
组件类和组件的元信息Spec
文件,包含组件相关的测试用例GreatAngular
组件会被自动地添加到最近模块 @NgModule
装饰器的 declarations
属性中。
2. 其他命令Angualr ClI
提供了许多常用命令供我们选择:
ng generate class my-new-class // 新建 classng generate component my-new-component // 新建组件ng generate directive my-new-directive // 新建指令ng generate enum my-new-enum // 新建枚举ng generate module my-new-module // 新建模块ng generate pipe my-new-pipe // 新建管道ng generate service my-new-service // 新建服务
当然选择。。简写:
ng g cl my-new-class // 新建 classng g c my-new-component // 新建组件ng g d my-new-directive // 新建指令ng g e my-new-enum // 新建枚举ng g m my-new-module // 新建模块ng g p my-new-pipe // 新建管道ng g s my-new-service // 新建服务
CLI git文档
3. 单元测试Angular
默认帮我们集成了``karma`测试框架,我们只需要:
$ ng test
4. 端到段测试
$ ng e2e
关于Angular
测试部分详细可以参考官方文档。
5. 构建应用程序
$ ng bulit
其中过程应该是这样的:Angular CLI
从 .angular-cli.json
文件中加载配置信息Angular CLI
运行 Webpack
打包项目相关的 JavaScript
、 CSS
等文件
打包后的资源,将被输出到配置文件中 outDir
所指定的目录,默认是输出到 dist
目录
这只是一个初级的文档,强烈建议请参考Angular CLI 终极指南
评论