支持政策
社区维护
🌐 Community Maintenance
Ionic 框架自一开始就完全开源（MIT 许可证），并且将永远保持开源。开发者可以通过 Ionic 的社区维护策略来确保 Ionic 是他们跨平台应用的正确选择。Ionic 团队会定期发布新版本、修复 bug，并且非常欢迎社区的拉取请求。
🌐 The Ionic Framework has been 100% open source (MIT) since the very beginning, and always will be. Developers can ensure Ionic is the right choice for their cross-platform apps through Ionic’s community maintenance strategy. The Ionic team regularly ships new releases, bug fixes, and is very welcoming to community pull requests.
框架维护和支持状态
🌐 Framework Maintenance and Support Status
鉴于时间和资源的限制以及希望在前端开发字段持续创新的现实，随着时间的推移，Ionic 团队需要将重点转向框架的新版本。然而，Ionic 将尽一切努力使向新版本的过渡尽可能顺利。Ionic 团队建议更新到最新版本的 Ionic 框架，以获取最新功能、改进和稳定性更新。
🌐 Given the reality of time and resource constraints as well as the desire to keep innovating in the frontend development space, over time it becomes necessary for the Ionic team to shift focus to newer versions of the Framework. However, Ionic will do everything it can to make the transition to newer versions as smooth as possible. The Ionic team recommends updating to the newest version of the Ionic Framework for the latest features, improvements and stability updates.
每个 Ionic Framework 版本的当前状态是：
🌐 The current status of each Ionic Framework version is:
| 版本 | 状态 | 发布日期 | 维护结束 | 扩展支持结束 |
|---|---|---|---|---|
| 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日 |
- 维护：仅限关键错误和安全修复。不进行重大功能改进。
- 扩展支持：对于需要额外长期维护支持的团队和组织，Ionic 提供扩展支持选项。要了解更多信息，请参阅我们的 企业产品。
兼容性建议
🌐 Compatibility Recommendations
Ionic 团队整理了一套使用 Ionic 框架与其他上下文相关软件结合的建议。这并非一个全面的列表，但涵盖了许多常见的兼容性问题。Ionic 团队强烈建议每季度审查一次项目依赖，以跟踪新版本、功能和错误修复情况。
🌐 The Ionic team has compiled a set of recommendations for using the Ionic Framework in conjunction with other contextually-relevant software. This is not meant to be a comprehensive list, but covers many common compatibility questions. The Ionic team strongly recommends reviewing your project dependencies once each quarter to keep track of new releases, features and bug fixes.
核心依赖
🌐 Core Dependencies
Ionic Angular
| 框架 | 最低 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 |
在旧版本 iOS 上支持 Angular 13+
Angular 对 iOS 的支持策略是最近两个主要版本。这意味着在 iOS 13 上使用 Ionic Angular v4-v6 可能需要对你的 Angular 项目进行更改。要支持 iOS 13，请将 tsconfig.json 中 compilerOptions 指定的项目 target 更改为 es5。如果不进行此更改，iOS 13 上应用启动时将出现 Unexpected token '.' in promiseReactionJob 错误。
🌐 Angular's support policy for iOS is the two most recent major versions. This means that changes to your Angular project may be necessary to use Ionic Angular v4-v6 on iOS 13. To support iOS 13, change the project target specified in compilerOptions in the tsconfig.json to es5. Without this change an error of Unexpected token '.' in promiseReactionJob will occur on app startup in iOS 13.
请注意，Ionic 的较新版本不支持 iOS 13；请参见此处的移动支持表。
🌐 Note that later versions of Ionic do not support iOS 13; see mobile support table here.
Ionic React
| 框架 | 所需 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
| 框架 | 所需 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+ |
原生桥梁
🌐 Native Bridges
| 框架 | 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 平台和产品
🌐 Ionic Platform & Products
| 框架 | Appflow | Ionic Native 高级插件* |
|---|---|---|
| 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 平台和产品（续）
🌐 Ionic Platform & Products (Cont.)
| 框架 | Ionic 工作室 | Ionic Native 社区插件* |
|---|---|---|
| V5 - 棱角 | “@ionic/angular” 5.X | @awesome-cordova-plugins 5.X |
| V5 - React | 目前不支持 | @awesome-cordova-plugins 5.X* |
| V4 - 棱角 | '@ionic/angular' 5.X | @awesome-cordova-plugins 5.X |
| V4 - React | 目前不支持 | @awesome-cordova-plugins 5.X* |
| V3 | 目前不支持 | @awesome-cordova-plugins 4.X |
- 封装器（及其相关插件）由社区维护。
- *可以使用 vanilla JavaScript 实现 来通过 Ionic Native 和
@ionic/react实现 Cordova 插件支持