支持政策
社区维护
Ionic Framework 从一开始就是 100% 开源 (MIT) 的,并且将始终如此。开发者可以通过 Ionic 的社区维护策略确保 Ionic 是其跨平台应用的正确选择。Ionic 团队定期发布新版本、错误修复,并且非常欢迎社区贡献的 Pull Request。
框架维护和支持状态
考虑到时间和资源的限制现实,以及在前端开发领域持续创新的愿望,随着时间的推移,Ionic 团队有必要将重点转移到较新版本的 Framework 上。然而,Ionic 将尽一切努力使过渡到新版本尽可能顺利。Ionic 团队建议更新到最新版本的 Ionic Framework,以获得最新的功能、改进和稳定性更新。
每个 Ionic Framework 版本的当前状态如下:
| 版本 | 状态 | 发布日期 | 维护结束日期 | 扩展支持结束日期 |
|---|---|---|---|---|
| V7 | 支持已结束 | Mar 29, 2023 | Oct 17, 2024 | Apr 17, 2025 |
| V6 | 支持已结束 | Dec 8, 2021 | Sep 29, 2023 | Mar 29, 2024 |
| V5 | 支持已结束 | Feb 11, 2020 | June 8, 2022 | Dec 8, 2022 |
| V4 | 支持已结束 | Jan 23, 2019 | Aug 11, 2020 | Sept 30, 2022 |
| V3 | 支持已结束 | Apr 5, 2017 | Oct 30, 2019 | Aug 11, 2020 |
| V2 | 支持已结束 | Jan 25, 2017 | Apr 5, 2017 | Apr 5, 2017 |
| V1 | 支持已结束 | May 12, 2015 | Jan 25, 2017 | Jan 25, 2017 |
- 维护:仅限关键错误和安全修复。无重大功能改进。
- 扩展支持:对于需要额外长期维护支持的团队和组织,Ionic 提供扩展支持选项。要了解更多信息,请查看我们的企业产品。
兼容性建议
Ionic 团队编制了一套关于将 Ionic Framework 与其他相关软件配合使用的建议。这并非旨在成为全面列表,但涵盖了许多常见的兼容性问题。Ionic 团队强烈建议每季度审查一次项目依赖项,以跟踪新版本、功能和错误修复。
核心依赖项
Ionic Angular
| 框架 | 最低 Angular 版本 | 最高 Angular 版本 | TypeScript |
|---|---|---|---|
| v7 | v14 | v17.x1 | 4.6+ |
| v6 | v12 | v15.x2 | 4.0+ |
| v5 | v8.2 | v12.x | 3.5+ |
| v4 | v8.2 | v11.x | 3.5+ |
| v3 | v5.2.11 | v5.2.11 | 2.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 |
|---|---|---|
| v7 | v17+ | 3.7+ |
| v6 | v17+ | 3.7+ |
| v5 | v16.8+ | 3.7+ |
| v4 | v16.8+ | 3.7+ |
Ionic Vue
| 框架 | 所需 Vue 版本 | TypeScript |
|---|---|---|
| v7 | v3.0.6+ | 3.9+ |
| v6 | v3.0.6+ | 3.9+ |
| v5 | v3.0+ | 3.9+ |
原生桥接
| 框架 | Cordova | Capacitor |
|---|---|---|
| V5 - Angular | cordova-android 8.X, cordova-ios 5.X | Latest 2.X |
| V5 - React | 不支持 | Latest 2.x |
| V5 - Vue | 不支持 | Latest 2.X |
| V4 - Angular | cordova-android 8.X, cordova-ios 5.X | Latest 2.X |
| V4 - React | 不支持 | Latest 2.x |
| V3 | cordova-android 8.X, cordova-ios 5.X | 不正式支持 |
- 随着 iOS 和 Android(以及相关工具)的更新,Cordova 和 Capacitor 也会有更多更新,因此建议保持在 Cordova 和 Capacitor 的最新版本上。
Ionic 平台与产品
| 框架 | Appflow | Ionic 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 | 使用最新可用版本 |
| V3 | ionic-angular 3.9.X | 使用最新版本;可能需要特殊配置 |
- Native Premier Plugins 需要
@ionic-enterprise/cordova进行安装,详见此处 - 对于 Capacitor 项目,请遵循 Capacitor 的 Cordova 插件安装指南
- 如果您需要在 Ionic 3 项目中使用 Enterprise 插件,请联系我们
Ionic 平台与产品(续)
| 框架 | Ionic Studio | Ionic 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 实现来实现。