在搭建 本地开发环境的过程中会安装很多 文件。它们大部分都可以被忽略掉。
The documentation setup procedures install a lot of files.
Most of them can be safely ignored.
对程序员来讲最重要的是在 src/
和 e2e/
文件夹之内 的应用文件。
Application files inside the src/
and e2e/
folders matter most to developers.
在这两个文件夹之外 的文件为开发环境设定条件。
这些文件很少会需要变动,你可能永远都不需要阅览或者修改它们。
Files outside those folders condition the development environment.
They rarely change and you may never view or modify them.
If you do, this page can help you understand their purpose.
文件
File
用途
Purpose
src/app/
你的 Angular 应用文件。
Angular application files go here.
"Hello Angular" 这个例子中有 AppComponent
、AppModule
、 一个组件单元测试 (app.component.spec.ts
) 以及引导文件 main.ts
。
Ships with the "Hello Angular" sample's
AppComponent
, AppModule
, a component unit test (app.component.spec.ts
), and
the bootstrap file, main.ts
.
在live example中试试范例程序 / 可下载的例子 和单元测试 / 可下载的例子
Try the sample application / downloadable example
and the unit test / downloadable example
as live examples .
e2e/
应用的端对端 (e2e)测试,用 Jasmine 写成并用 protractor 端对端测试运行器测试。
End-to-end (e2e) tests of the application,
written in Jasmine and run by the
protractor
e2e test runner.
初始化后,有个“Hello Angular” 的例子的端对端测试。
Initialized with an e2e test for the "Hello Angular" sample.
node_modules/
用 npm install
命令安装的 npm 包。
The npm packages installed with the npm install
command.
.editorconfig
.git/
.gitignore
.travis.yml
配置文件和文件夹的工具。
Tooling configuration files and folders.
除非非常必要,否则可以忽略。
Ignore them until you have a compelling reason to do otherwise.
CHANGELOG.md
快速起步 库的更新历史。
The history of changes to the QuickStart repository.
删除或忽略。
Delete or ignore.
favicon.ico
出现在浏览器标签上的应用图标。
The application icon that appears in the browser tab.
index.html
应用的宿主页面。
它以特定的顺序加载一些基本脚本。
然后它启动应用,将根AppComponent
放置到自定义<my-app>
标签里。
The application host page.
It loads a few essential scripts in a prescribed order.
Then it boots the application, placing the root AppComponent
in the custom <my-app>
body tag.
同一个 index.html
满足所有文档应用例子。
The same index.html
satisfies all documentation application samples.
karma.conf.js
在测试 指南中提到的 karma 测试运行器的配置。
Configuration for the karma
test runner described in the Testing guide.
karma-test-shim.js
在测试 指南中提到的 karma 测试运行器的脚本。
Script to run karma
with SystemJS as described in the Testing guide.
non-essential-files.txt
这个列表中的文件在清理时可以删除,它是原始的“快速起步”种子工程中的测试和git维护文件。
步骤参见可选的删除非必要文件 部分。
只在最初做这件事,以免不小心删除了你自己的测试文件和git配置!
A list of files that you can delete if you want to purge your setup of the
original QuickStart Seed testing and git maintainence artifacts.
See instructions in the optional
Deleting non-essential files section.
Do this only in the beginning to avoid accidentally deleting your own tests and git setup!
LICENSE
应用的搭建代码中用到的开源 MIT 许可证。
The open source MIT license to use this setup code in your application.
package.json
为项目指定npm
依赖包。
Identifies npm
package dependencies for the project.
包含了一些命令脚本,用来运行应用、运行测试与其他。输入npm run
来查看命令列表。
到这里 阅读更多关于它们的说明。
Contains command scripts for running the application,
running tests, and more. Enter npm run
for a listing.
Read more about them.
protractor.config.js
protractor 端对端 (e2e) 测试器运行器的配置。
Configuration for the
protractor
end-to-end (e2e) test runner.
README.md
项目中使用这个 git 库的说明。
在删除前值得阅读。
Instruction for using this git repository in your project.
Worth reading before deleting.
styles.css
应用的全局样式。初始化后,有个为《快速起步》演示准备的<h1>
样式。
Global styles for the application. Initialized with an <h1>
style for the QuickStart demo.
systemjs .config.js
为 SystemJS 模块加载器指定去哪儿查找在 JavaScript 的import
语句中引用的模块。例如:
Tells the SystemJS module loader where to find modules
referenced in JavaScript import
statements. For example:
Copy Code
import { Component } from '@angular/core;
除非你完全理解 SystemJS 的配置,不要修改它。
Don't touch this file unless you are fully versed in SystemJS configuration.
systemjs .config.extras.js
可选的额外 SystemJS 配置。
是添加 SystemJS 映射的途径,例如在无需修改原始systemjs.config.js
的情况下为应用映射封装桶 。
Optional extra SystemJS configuration.
A way to add SystemJS mappings, such as for appliation barrels ,
without changing the original system.config.js
.
tsconfig.json
为 TypeScript 编译器指定如何将 TypeScript 代码转换为 JavaScript 文件,用来在所有现代浏览器中运行。
Tells the TypeScript compiler how to transpile TypeScript source files
into JavaScript files that run in all modern browsers.
tslint.json
利用npm
安装的 TypeScript 语法检查器 (linter) 检测 TypeScript 代码并在你违反它的规则时提示你。
The npm
installed TypeScript linter inspects your TypeScript code
and complains when you violate one of its rules.
该文件定义了 Angular 风格指南 与本文档站作者喜爱的语法检查规则。
This file defines linting rules favored by the
Angular style guide and by the authors of the documentation.