Angular HMR 实践指南

本指南将带你深入了解 PatrickJS 的 angular-hmr 开源项目，旨在帮助开发者快速掌握如何组织和管理具有热模块替换（Hot Module Replacement, HMR）功能的Angular应用程序。我们将依次探索项目的目录结构、启动文件以及关键配置文件，确保你能高效地集成并利用这一强大的开发工具。

1. 项目目录结构及介绍

典型的Angular项目，包括angular-hmr在内，遵循一定的目录规范。以下是一般性的结构说明，具体细节可能会有所不同：

• src: 应用的核心所在，它包含了应用的主要代码。

  • app: 存放组件、服务和其他业务逻辑相关的文件。
  • assets: 静态资源如图片、字体文件等存放的地方。
  • environments: 不同环境（如生产与开发）的配置文件。
  • index.html: 应用的入口页面。
  • main.ts: 应用程序的主入口文件，启动时执行。
  • polyfills.ts: 提供浏览器兼容性所需的 polyfill 文件。
  • styles.css: 全局样式文件。

• e2e: 端到端测试相关文件。

• node_modules: 第三方依赖库存放位置。

• .gitignore: Git忽略文件配置。

• package.json: 包含了项目的元数据，脚本命令和依赖列表。

• tsconfig.json: TypeScript编译器的配置文件，指导TypeScript代码如何编译。

• angular.json: Angular工作区配置文件，控制构建和开发服务器的设置。

2. 项目的启动文件介绍

在angular-hmr项目中，核心的启动文件是src/main.ts。这是应用执行的第一个TypeScript文件。当集成HMR时，还需要对这个文件或者配置文件进行特定的调整以启用HMR特性。通常，开发者需要通过CLI命令添加—hmr标志来启动HMR，例如修改或直接在package.json中的scripts字段加入 "start": "ng serve --hmr"，以便通过npm start或yarn start命令直接开启HMR模式的开发服务器。

3. 项目的配置文件介绍

package.json

• scripts: 这里定义了项目的可执行脚本，如添加的start脚本用于启动开发服务器，其中--hmr参数特别用于激活热模块替换。

angular.json

• projects -> architect -> serve -> options: 在这里，你可以配置开发服务器的相关选项，包括是否默认启用HMR。虽然直接在命令行中添加--hmr更为常见，但理论上也可以通过编辑这里的configuration来默认开启。

tsconfig.json

• 配置TypeScript编译选项，虽然HMR主要由Angular CLI处理其集成，但在某些高级定制场景下，可能需要调整编译配置来支持ES模块等特性，以更好地配合HMR的工作机制。

.angular-cli.json (老旧配置文件)

对于较旧版本的Angular CLI项目，配置项可能位于.angular-cli.json，但请注意，现代Angular项目推荐使用angular.json。

总结，在使用patrickJS/angular-hmr或是任何类似配置HMR的Angular项目时，理解这些基础组件和配置文件的交互至关重要。正确配置这些部分，可以极大提升你的开发效率，让你享受即时反馈的开发体验。