首页
/ Apollo Angular 9.0.0 发布:重大升级与改进

Apollo Angular 9.0.0 发布:重大升级与改进

2025-07-01 23:04:04作者:滕妙奇

Apollo Angular 是一个将 GraphQL 与 Angular 框架集成的库,它允许开发者在前端应用中轻松地使用 GraphQL 进行数据查询和管理。最近发布的 9.0.0 版本带来了几个重要的变化和改进,值得开发者关注。

主要变更

依赖升级

Apollo Angular 9.0.0 现在要求使用 @apollo/client 3.13.1 或更高版本。这一变更确保了库与最新的 Apollo Client 功能保持同步,同时也意味着开发者需要相应地更新他们的项目依赖。

SubscriptionResult 移除

在这个版本中,开发团队决定移除 SubscriptionResult 类型。这个决定基于两个主要原因:

  1. 维护成本:保持这个类型与原生类型同步需要额外的工作量
  2. 价值有限:这个类型并没有提供比原生类型更多的价值

开发者现在可以直接使用 @apollo/client/core 中的 FetchResult 类型来代替原来的 SubscriptionResult。这一变更简化了代码库,同时保持了相同的功能。

QueryRef 改进

QueryRef 类在这个版本中得到了显著改进:

  1. 类型转发:现在大多数方法都会直接使用 @apollo/client 的原生类型,这意味着无论安装哪个版本的 @apollo/client,都能自动获得正确的类型支持,而不需要 Apollo Angular 做额外的调整。

  2. 属性保护:valueChanges 和 queryId 属性现在被标记为只读,因为这些属性不应该被重新赋值,这一改变有助于防止意外的修改。

其他更新

除了上述主要变更外,这个版本还包含了一些依赖项的更新,确保库的稳定性和兼容性。

升级建议

对于正在使用 Apollo Angular 的开发者,升级到 9.0.0 版本需要注意以下几点:

  1. 确保项目中 @apollo/client 的版本至少为 3.13.1
  2. 查找并替换所有 SubscriptionResult 的使用,改用 FetchResult
  3. 检查是否有代码尝试修改 QueryRef 的 valueChanges 或 queryId 属性,这些操作现在会被阻止

这次升级虽然包含了一些破坏性变更,但这些改变都是为了简化代码库和提高稳定性。移除 SubscriptionResult 减少了维护负担,而 QueryRef 的改进则提供了更好的类型安全性和使用体验。

对于新项目,建议直接使用 9.0.0 版本以利用这些改进。对于现有项目,可以在测试环境中先进行升级验证,确保所有功能正常工作后再部署到生产环境。

登录后查看全文
热门项目推荐
相关项目推荐