支持政策
社区维护
Ionic Framework 从一开始就是 100% 开源(MIT)的,并且将永远如此。开发者可以通过 Ionic 的社区维护策略确保 Ionic 是其跨平台应用的正确选择。Ionic 团队定期发布新版本和 bug 修复,并且非常欢迎社区的 pull request。
框架维护和支持状态
考虑到时间和资源限制的现实以及在前端开发领域持续创新的愿望,随着时间的推移,Ionic 团队有必要将重点转移到较新的 Framework 版本上。然而,Ionic 将尽一切努力使向新版本的过渡尽可能顺利。Ionic 团队建议更新到最新版本的 Ionic Framework,以获取最新的功能、改进和稳定性更新。
每个 Ionic Framework 版本的当前状态如下:
| 版本 | 状态 | 发布日期 | 维护结束日期 | 扩展支持结束日期 |
|---|---|---|---|---|
| V8 | 活跃 | 2024年4月17日 | 待定 | 待定 |
| V7 | 支持已结束 | 2023年3月29日 | 2024年10月17日 | 2025年4月17日 |
| V6 | 支持已结束 | 2021年12月8日 | 2023年9月29日 | 2024年3月29日 |
| V5 | 支持已结束 | 2020年2月11日 | 2022年6月8日 | 2022年12月8日 |
| V4 | 支持已结束 | 2019年1月23日 | 2020年8月11日 | 2022年9月30日 |
| V3 | 支持已结束 | 2017年4月5日 | 2019年10月30日 | 2020年8 月11日 |
| V2 | 支持已结束 | 2017年1月25日 | 2017年4月5日 | 2017年4月5日 |
| V1 | 支持已结束 | 2015年5月12日 | 2017年1月25日 | 2017年1月25日 |
- 维护:仅限关键 bug 和安全修复。没有主要功能改进。
- 扩展支持:对于需要额外长期维护支持的团队和组织,Ionic 提供扩展支持选项。要了解更多信息,请参阅我们的企业服务。
兼容性建议
Ionic 团队整理了一套关于将 Ionic Framework 与其他相关软件配合使用的建议。这并非全面列表,但涵盖了许多常见的兼容性问题。Ionic 团队强烈建议每季度审查一次项目依赖项,以跟踪新版本、功能和 bug 修复。
核心依赖项
Ionic Angular
| Framework | 最低 Angular 版本 | 最高 Angular 版本 | TypeScript |
|---|---|---|---|
| v8 | v16 | v20.x1 | 4.9.3+ |
| v7 | v14 | v17.x2 | 4.6+ |
| v6 | v12 | v15.x3 | 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 的支持政策是最新的两个主版本。这意味着可能需要对你的 Angular 项目进行更改,以在 iOS 13 上使用 Ionic Angular v4-v6。要支持 iOS 13,请将 tsconfig.json 中 compilerOptions 指定的项目 target 更改为 es5。如果不进行此更改,iOS 13 上的应用启动将出现 Unexpected token '.' in promiseReactionJob 错误。
请注意,较新版本的 Ionic 不支持 iOS 13;请参见此处的移动端支持表格。
Ionic React
| Framework | 所需 React 版本 | TypeScript |
|---|---|---|
| v8 | v17+ | 3.7+ |
| v7 | v17+ | 3.7+ |
| v6 | v17+ | 3.7+ |
| v5 | v16.8+ | 3.7+ |
| v4 | v16.8+ | 3.7+ |
Ionic Vue
| Framework | 所需 Vue 版本 | TypeScript |
|---|---|---|
| v8 | v3.0.6+ | 3.9+ |
| v7 | v3.0.6+ | 3.9+ |
| v6 | v3.0.6+ | 3.9+ |
| v5 | v3.0+ | 3.9+ |
原生桥接
| Framework | Cordova | Capacitor |
|---|---|---|
| V5 - Angular | cordova-android 8.X, cordova-ios 5.X | 最新的 2.X |
| V5 - React | 不支持 | 最新的 2.x |
| V5 - Vue | 不支持 | 最新的 2.X |
| V4 - Angular | cordova-android 8.X, cordova-ios 5.X | 最新的 2.X |
| V4 - React | 不支持 | 最新的 2.x |
| V3 | cordova-android 8.X, cordova-ios 5.X | 未正式支持 |
- 随着 iOS 和 Android(及相关工具)的更新,Cordova 和 Capacitor 也会有更多更新,因此建议保持在 Cordova 和 Capacitor 的最新版本。
Ionic 平台与产品
| Framework | Appflow | Ionic Native Premier 插件* |
|---|---|---|
| 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 插件需要
@ionic-enterprise/cordova进行安装 请参见此处 - 对于 Capacitor 项目,请遵循 Capacitor Cordova 插件安装指南
- 如果你需要在 Ionic 3 项目中使用企业插件,请联系我们
Ionic 平台与产品(续)
| Framework | Ionic Studio | Ionic Native 社区插件* |
|---|---|---|
| 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 插件支持可以通过vanilla JavaScript 实现来实现。