共享依赖项
在远程模块之间共享 Angular 和库
共享依赖项 是 CoddyKit 上的免费 Angular Academy 课时。 这是第 3 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Angular Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Angular Academy 课程共包含 4 节课。
为什么要共享依赖
如果主机和三个远程部分各自打包一份 Angular,浏览器就会下载四次 Angular;更糟糕的是,最终会存在多个 Angular 实例,从而破坏依赖注入。共享可以确保只加载一份,并由所有部分复用。
shared 部分
在 federation.config.js 中,shared 对象声明主机和远程部分之间共享哪些依赖。Native Federation 会在运行时将这些依赖去重。
module.exports = withNativeFederation({
shared: {
...shareAll({ singleton: true, strictVersion: true }),
},
});shareAll 辅助函数
shareAll() 会通过一项配置共享 package.json 中的所有依赖,这是常见的起点。然后您可以覆盖特定的软件包。
shared: {
...shareAll({ singleton: true, strictVersion: true, requiredVersion: 'auto' }),
}singleton:为什么对 Angular 很重要
singleton: true 会强制整个应用中某个软件包只能有一个实例。Angular 核心库、RxJS 和路由器必须使用单例;两份 @angular/core 意味着存在两棵注入器树,并会产生运行时错误。
版本协商
当远程部分请求不同版本时,联邦机制会选择兼容的版本。strictVersion: true 会在版本不兼容时抛出错误,而不是静默加载不匹配的版本,从而尽早暴露问题。
shared: {
'@angular/core': { singleton: true, strictVersion: true, requiredVersion: '^18.0.0' },
}共享自有库
共享的设计系统库或身份验证库也应设为单例,以确保状态(例如当前用户)保持一致。请按名称显式共享它。
shared: {
'@myorg/design-system': { singleton: true, requiredVersion: 'auto' },
'@myorg/auth': { singleton: true },
}requiredVersion:auto
requiredVersion: 'auto' 会从 package.json 读取版本,因此无需硬编码。升级依赖时,这可以让配置保持同步。
运行时会发生什么
每个构建版本都会生成关于其共享软件包的元数据。加载时,联邦机制会比较主机和远程部分的版本,并通过导入映射提供一个共享模块,因此浏览器只需获取一次。
不共享的代价
忘记共享 Angular 是最常见的错误:应用似乎可以运行,随后却抛出类似“NG0203: inject() must be called from an injection context”的难以理解的错误,因为应用中存在两份 Angular。将其设为单例共享可以避免此问题。
保持版本一致
独立部署可能会导致版本逐渐偏离。团队应就框架软件包的共享版本范围达成一致,并协调升级,因为使用 Angular 18 的主机无法安全地与需要 Angular 17 的远程部分共享。
不共享某个软件包
有时,远程部分需要某个小型工具库的独立副本。您可以将其排除在共享范围之外,让它私有打包,以增加重复体积为代价换取独立性。
shared: {
...shareAll({ singleton: true }),
}
// skip a package by removing it from the shared map / excluding it快速检查
哪些软件包必须使用单例?
回顾
声明 shared 依赖(通常通过 shareAll),让主机和远程部分加载同一份副本。将框架和有状态库(@angular/core、路由器、RxJS、您的身份验证库)设置为 singleton: true;使用 strictVersion 和 requiredVersion: 'auto' 检测版本偏离。忘记共享 Angular 会导致 DI 错误。
常见问题解答
「共享依赖项」课时是免费的吗?
是的 — 「共享依赖项」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Angular Academy 课程的其余内容,请升级到 CoddyKit PRO。 Angular Academy 课程共包含 4 节课。
「共享依赖项」这节课中我会学到什么?
在远程模块之间共享 Angular 和库 你通过在浏览器中直接运行的动手代码来练习 Angular Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Angular Academy 需要有经验吗?
无需任何先前经验。CoddyKit 上的 Angular Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 3 节课,共 4 节。
「共享依赖项」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 Angular Academy 课中编写并运行代码吗?
能。每节 Angular Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。