Skip to content

Commit eb2c6ab

Browse files
authored
docs(capacitor): document Capacitor 7 minimum and v2 removal for v9 (#4592)
1 parent 8305a5b commit eb2c6ab

2 files changed

Lines changed: 18 additions & 8 deletions

File tree

docs/reference/support.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -97,16 +97,20 @@ Note that later versions of Ionic do not support iOS 13; see [mobile support tab
9797

9898
### Native Bridges
9999

100-
| Framework | Cordova | Capacitor |
101-
| :----------: | :----------------------------------: | :----------------------: |
102-
| V5 - Angular | cordova-android 8.X, cordova-ios 5.X | Latest 2.X |
103-
| V5 - React | Not supported | Latest 2.x |
104-
| V5 - Vue | Not supported | Latest 2.X |
105-
| V4 - Angular | cordova-android 8.X, cordova-ios 5.X | Latest 2.X |
106-
| V4 - React | Not supported | Latest 2.x |
107-
| V3 | cordova-android 8.X, cordova-ios 5.X | Not officially supported |
100+
| Framework | Cordova | Capacitor |
101+
| :------------: | :----------------------------------: | :----------------------: |
102+
| V9: Angular | cordova-android 8.X, cordova-ios 5.X | 7.X+ |
103+
| V9: React | Not supported | 7.x+ |
104+
| V9: Vue | Not supported | 7.X+ |
105+
| V5-V8: Angular | cordova-android 8.X, cordova-ios 5.X | 2.X+ |
106+
| V5-V8: React | Not supported | 2.x+ |
107+
| V5-V8: Vue | Not supported | 2.X+ |
108+
| V4: Angular | cordova-android 8.X, cordova-ios 5.X | 2.X+ |
109+
| V4: React | Not supported | 2.x+ |
110+
| V3 | cordova-android 8.X, cordova-ios 5.X | Not officially supported |
108111

109112
- As iOS and Android (and related tools) are updated, you can expect more updates for Cordova and Capacitor, so it is recommended to stay on the latest version(s) of Cordova and Capacitor.
113+
- Starting with Ionic v9, Capacitor 7 is the minimum officially supported version. Earlier versions of Ionic ran on Capacitor 2 and later.
110114

111115
### Ionic Platform & Products
112116

docs/updating/9-0.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -432,6 +432,12 @@ Safari >=16
432432
iOS >=16
433433
```
434434

435+
### Capacitor
436+
437+
Ionic 9 officially supports Capacitor 7 and later. Native platform detection no longer falls back to the Capacitor 2 `isNative` flag; `isCapacitorNative` now relies solely on `Capacitor.isNativePlatform()`, which was added in Capacitor 3.
438+
439+
If your app is still on Capacitor 2, it will no longer be detected as running on a native platform, so `isPlatform('capacitor')`, `isPlatform('hybrid')`, and `getPlatforms()` will report `web` instead of native. Upgrade to Capacitor 7 or later by following the [Capacitor updating guides](https://capacitorjs.com/docs/updating/7-0).
440+
435441
### Legacy Picker
436442

437443
1. Remove any usages of the `ion-picker-legacy` and `ion-picker-legacy-column` components. These components have been removed in Ionic 9. The recommended path forward is to use `ion-picker` inside a modal. Review the [Picker in Modal documentation](../api/picker.md#picker-in-modal) for more information.

0 commit comments

Comments
 (0)