capacitor-plugin-upgrades

To upgrade a Capacitor plugin to a new major version, update @capacitor/* peer dependencies, adjust native bridge code for iOS and Android, run npm install and cap sync, then validate functionality in the example app.

During a Capacitor plugin upgrade, cap sync updates native dependencies and copies web assets to ensure the iOS and Android native projects match the newly installed target major version configurations.

You should not skip major versions when upgrading a Capacitor plugin. A sequential upgrade path performs upgrades across each major version increment to ensure gradual compatibility and minimize breaking changes.

Native platform settings break after a Capacitor major version upgrade because native wiring and iOS/Android project configurations must be adapted to match the new Capacitor version's updated bridge requirements and peer dependencies.

To verify API compatibility after updating Capacitor peer dependencies, rebuild and validate the plugin in its example or test app to confirm that the native bridge and web APIs function correctly.

Yes, upgrading a Capacitor plugin requires updating both iOS and Android native project settings. Native platform adaptations are necessary to align the native wiring with the target Capacitor major version.