快速上手
快速上手
好的工具能让开发更加简单快捷。
Angular CLI
是一个命令行界面
工具,它可以创建项目、添加文件以及执行一大堆开发任务,比如测试、打包和发布。
本章的目标是构建并运行一个超级简单的 TypeScript Angular 应用。使用 Angular CLI 来让每个
Angular 应用从风格指南的那些建议中获益。
在本章的末尾,你会对用 CLI 进行开发有一个最基本的理解,并将其作为其它文档范例以及真实应用的基础。
你还可以 下载这个例子。
步骤 1. 设置开发环境
在开始工作之前,你必须设置好开发环境。
如果你的电脑里没有 Node.js®和 npm,请安装它们
。
请先在终端/控制台窗口中运行命令 node -v
和 npm
-v, 来验证一下你正在运行 node
8.x
和 npm
5.x
以上的版本。
更老的版本可能会出现错误,更新的版本则没问题。
然后全局安装 Angular CLI。
content_copynpm install -g @angular/cli
步骤 2. 创建新项目
打开终端窗口。
运行下列命令来生成一个新项目以及默认的应用代码:
content_copyng new my-app
Angular CLI 会安装必要的 NPM 包、创建项目文件,并在该项目中生成一个简单的默认应用。这可能要花一点时间。
你可以使用 ng add
命令往新项目中添加一些预先打包好的功能。 ng add
命令会通过应用来自特定 NPM 包中的图纸(schematic)来转换此项目。 要了解更多,参见 Angular CLI 文档。
比如 Angular Material 就为一些典型布局提供了图纸。参见 Angular Material 文档。
步骤 3. 启动开发服务器
进入项目目录,并启动服务器。
content_copycd my-app
ng serve --open
ng serve
命令会启动开发服务器,监听文件变化,并在修改这些文件时重新构建此应用。
使用 --open
(或 -o
)参数可以自动打开浏览器并访问 http://localhost:4200/
。
本应用会用一条消息来跟你打招呼:
步骤 4. 编辑你的第一个 Angular 组件
这个 CLI 为你创建了第一个 Angular 组件。 它就是名叫 app-root
的根组件
。 你可以在 ./src/app/app.component.ts
目录下找到它。
打开这个组件文件,并且把 title
属性从 'app'
改为 'My First Angular App!'
:
src/app/app.component.ts
content_copyexport class AppComponent {
title = 'My First Angular App!';
}
浏览器会自动刷新,并具有修改之后的标题。不错,不过它还可以更好看一点。
打开 src/app/app.component.css
并给这个组件设置一些样式
src/app/app.component.css
content_copyh1 {
color: #369;
font-family: Arial, Helvetica, sans-serif;
font-size: 250%;
}
漂亮!
接下来呢?
这就是你期待这个 “Hello, World” 应用要做的。
现在,你可以开始英雄指南教程,通过构建一个小型应用来学习如何用 Angular 构建各种大型应用了。
或者,你也可以稍等一会儿,学学在这个新项目中的文件都是干什么用的。
项目文件概览
Angular CLI 项目是做快速试验和开发企业解决方案的基础。
你首先要看的文件是 README.md
。 它提供了一些如何使用 CLI 命令的基础信息。 如果你想了解 Angular CLI 的工作原理,请访问 Angular CLI 的仓库及其 Wiki。
有些生成的文件你可能觉得陌生。
src 文件夹
你的应用代码位于 src
文件夹中。 所有的 Angular 组件、模板、样式、图片以及你的应用所需的任何东西都在那里。 这个文件夹之外的文件都是为构建应用提供支持用的。
src
app
app.component.css
app.component.html
app.component.spec.ts
app.component.ts
app.module.ts
assets
.gitkeep
environments
environment.prod.ts
environment.ts
browserslist
favicon.ico
index.html
karma.conf.js
main.ts
polyfills.ts
styles.css
test.ts
tsconfig.app.json
tsconfig.spec.json
tslint.json
文件 | 用途 |
---|---|
app/app.component.{ts,html,css,spec.ts} | 使用 HTML 模板、CSS 样式和单元测试定义 AppComponent 组件。 它是根组件,随着应用的成长它会成为一棵组件树的根节点。 |
app/app.module.ts | 定义 AppModule,根模块为 Angular 描述如何组装应用。 目前,它只声明了 AppComponent。 不久,它将声明更多组件。 |
assets/* | 这个文件夹下你可以放图片等任何东西,在构建应用时,它们全都会拷贝到发布包中。 |
environments/* | 这个文件夹中包括为各个目标环境准备的文件,它们导出了一些应用中要用到的配置变量。 这些文件会在构建应用时被替换。 比如你可能在生产环境中使用不同的 API 端点地址,或使用不同的统计 Token 参数。 甚至使用一些模拟服务。 所有这些,CLI 都替你考虑到了。 |
browserslist | 一个配置文件,用来在不同的前端工具之间共享目标浏览器。 |
favicon.ico | 每个网站都希望自己在书签栏中能好看一点。 请把它换成你自己的图标。 |
index.html | 这是别人访问你的网站是看到的主页面的 HTML 文件。 大多数情况下你都不用编辑它。 在构建应用时,CLI 会自动把所有 js 和 css 文件添加进去,所以你不必在这里手动添加任何 <script> 或 <link> 标签。 |
karma.conf.js | 给Karma的单元测试配置,当运行 ng test 时会用到它。 |
main.ts | 这是应用的主要入口点。 使用JIT 编译器编译本应用,并启动应用的根模块 AppModule,使其运行在浏览器中。 你还可以使用AOT 编译器,而不用修改任何代码 —— 只要给 ng build 或 ng serve传入 --aot 参数就可以了。 |
polyfills.ts | 不同的浏览器对 Web 标准的支持程度也不同。 腻子脚本(polyfill)能把这些不同点进行标准化。 你只要使用 core-js 和 zone.js 通常就够了,不过你也可以查看浏览器支持指南以了解更多信息。 |
styles.css | 这里是你的全局样式。 大多数情况下,你会希望在组件中使用局部样式,以利于维护,不过那些会影响你整个应用的样式你还是需要集中存放在这里。 |
test.ts | 这是单元测试的主要入口点。 它有一些你不熟悉的自定义配置,不过你并不需要编辑这里的任何东西。 |
tsconfig.{app|spec}.json | TypeScript 编译器的配置文件。tsconfig.app.json 是为 Angular 应用准备的,而 tsconfig.spec.json 是为单元测试准备的。 |
tslint.json | 额外的 Linting 配置。当运行 ng lint时,它会供带有 Codelyzer 的 TSLint 使用。 Linting 可以帮你们保持代码风格的一致性。 |
根目录
src/
文件夹是项目的根文件夹之一。 其它文件是用来帮助你构建、测试、维护、文档化和发布应用的。它们放在根目录下,和 src/
平级。
my-app
e2e
src
app.e2e-spec.ts
app.po.ts
tsconfig.e2e.json
protractor.conf.js
node_modules/...
src/...
karma.conf.js
.editorconfig
.gitignore
angular.json
package.json
README.md
tsconfig.json
tslint.json
文件 | 用途 |
---|---|
e2e/ | 在 e2e/ 下是端到端(end-to-end)测试。 它们不在 src/ 下,是因为端到端测试实际上和应用是相互独立的,它只适用于测试你的应用而已。 这也就是为什么它会拥有自己的 tsconfig.json。 |
node_modules/ | Node.js 创建了这个文件夹,并且把 package.json 中列举的所有第三方模块都放在其中。 |
.editorconfig | 给你的编辑器看的一个简单配置文件,它用来确保参与你项目的每个人都具有基本的编辑器配置。 大多数的编辑器都支持 .editorconfig 文件,详情参见 http://editorconfig.org 。 |
.gitignore | 一个 Git 的配置文件,用来确保某些自动生成的文件不会被提交到源码控制系统中。 |
angular.json | Angular CLI 的配置文件。 在这个文件中,你可以设置一系列默认值,还可以配置项目编译时要包含的那些文件。 要了解更多,请参阅它的官方文档。 |
package.json | npm 配置文件,其中列出了项目使用到的第三方依赖包。 你还可以在这里添加自己的自定义脚本。 |
protractor.conf.js | 给Protractor使用的端到端测试配置文件,当运行 ng e2e 的时候会用到它。 |
README.md | 项目的基础文档,预先写入了 CLI 命令的信息。 别忘了用项目文档改进它,以便每个查看此仓库的人都能据此构建出你的应用。 |
tsconfig.json | TypeScript 编译器的配置,你的 IDE 会借助它来给你提供更好的帮助。 |
tslint.json | 给TSLint和Codelyzer用的配置信息,当运行 ng lint 时会用到。 Lint 功能可以帮你保持代码风格的统一。 |
下一步
如果你刚刚开始使用 Angular,请继续这个教程。 你可以跳过“环境设置”一章,因为你已经在使用 Angular CLI 设置好环境了。