跳到主要内容
版本:v7

支持政策

社区维护

Ionic Framework 从一开始就是 100% 开源 (MIT) 的,并且将始终如此。开发者可以通过 Ionic 的社区维护策略确保 Ionic 是其跨平台应用的正确选择。Ionic 团队定期发布新版本、错误修复,并且非常欢迎社区贡献的 Pull Request。

框架维护和支持状态

考虑到时间和资源的限制现实,以及在前端开发领域持续创新的愿望,随着时间的推移,Ionic 团队有必要将重点转移到较新版本的 Framework 上。然而,Ionic 将尽一切努力使过渡到新版本尽可能顺利。Ionic 团队建议更新到最新版本的 Ionic Framework,以获得最新的功能、改进和稳定性更新。

每个 Ionic Framework 版本的当前状态如下:

版本状态发布日期维护结束日期扩展支持结束日期
V7支持已结束Mar 29, 2023Oct 17, 2024Apr 17, 2025
V6支持已结束Dec 8, 2021Sep 29, 2023Mar 29, 2024
V5支持已结束Feb 11, 2020June 8, 2022Dec 8, 2022
V4支持已结束Jan 23, 2019Aug 11, 2020Sept 30, 2022
V3支持已结束Apr 5, 2017Oct 30, 2019Aug 11, 2020
V2支持已结束Jan 25, 2017Apr 5, 2017Apr 5, 2017
V1支持已结束May 12, 2015Jan 25, 2017Jan 25, 2017
  • 维护:仅限关键错误和安全修复。无重大功能改进。
  • 扩展支持:对于需要额外长期维护支持的团队和组织,Ionic 提供扩展支持选项。要了解更多信息,请查看我们的企业产品

兼容性建议

Ionic 团队编制了一套关于将 Ionic Framework 与其他相关软件配合使用的建议。这并非旨在成为全面列表,但涵盖了许多常见的兼容性问题。Ionic 团队强烈建议每季度审查一次项目依赖项,以跟踪新版本、功能和错误修复。

核心依赖项

Ionic Angular

框架最低 Angular 版本最高 Angular 版本TypeScript
v7v14v17.x14.6+
v6v12v15.x24.0+
v5v8.2v12.x3.5+
v4v8.2v11.x3.5+
v3v5.2.11v5.2.112.6.2

Angular 13+ 在旧版 iOS 上的支持

Angular 对 iOS 的支持政策是最新的两个主要版本。这意味着在 iOS 13 上使用 Ionic Angular v4-v6 时,可能需要对 Angular 项目进行更改。要支持 iOS 13,请将 tsconfig.json 中 compilerOptions 指定的 target 更改为 es5。如果不进行此更改,iOS 13 上的应用启动时会出现 Unexpected token '.' in promiseReactionJob 错误。

请注意,较新版本的 Ionic 不支持 iOS 13;请参阅此处的移动支持表。

Ionic React

框架所需 React 版本TypeScript
v7v17+3.7+
v6v17+3.7+
v5v16.8+3.7+
v4v16.8+3.7+

Ionic Vue

框架所需 Vue 版本TypeScript
v7v3.0.6+3.9+
v6v3.0.6+3.9+
v5v3.0+3.9+

原生桥接

框架CordovaCapacitor
V5 - Angularcordova-android 8.X, cordova-ios 5.XLatest 2.X
V5 - React不支持Latest 2.x
V5 - Vue不支持Latest 2.X
V4 - Angularcordova-android 8.X, cordova-ios 5.XLatest 2.X
V4 - React不支持Latest 2.x
V3cordova-android 8.X, cordova-ios 5.X不正式支持
  • 随着 iOS 和 Android(以及相关工具)的更新,Cordova 和 Capacitor 也会有更多更新,因此建议保持在 Cordova 和 Capacitor 的最新版本上。

Ionic 平台与产品

框架AppflowIonic Native Premier Plugins*
V5 - Angular@ionic/angular 5.X使用最新可用版本
V5 - React@ionic/react 5.X使用最新可用版本
V4 - Angular@ionic/angular 4.X使用最新可用版本
V4 - React@ionic/react 4.X使用最新可用版本
V3ionic-angular 3.9.X使用最新版本;可能需要特殊配置

Ionic 平台与产品(续)

框架Ionic StudioIonic Native Community Plugins*
V5 - Angular@ionic/angular 5.X@awesome-cordova-plugins 5.X
V5 - React目前不支持@awesome-cordova-plugins 5.X*
V4 - Angular@ionic/angular 5.X@awesome-cordova-plugins 5.X
V4 - React目前不支持@awesome-cordova-plugins 5.X*
V3目前不支持@awesome-cordova-plugins 4.X
  • 封装器(及其关联的插件)由社区维护。
  • * 使用 Ionic Native 和 @ionic/react 的 Cordova 插件支持可以通过纯 JavaScript 实现来实现。

Footnotes

  1. Angular 17.x 从 Ionic v7.5.4 开始支持。

  2. Angular 14.x 从 Ionic v6.1.9 开始支持。Angular 15.x 从 Ionic v6.3.6 开始支持。