From V7 to V8

Copy a setup prompt with the install steps and the full markdown guide for this plugin.

Why this upgrade

This major version is here to follow Capacitor major version 8

First follow the migration guide of Capacitor:

https://capacitorjs.com/docs/updating/8-0

iOS Minimum Version Requirement

The iOS minimum deployment target has been bumped to 15 to ensure that iOS devices with CVE-2022-36943 are excluded. This is the minimum version of the iOS zip library that has the security fix implemented.

Install

npm i @capgo/capacitor-updater@8

Then sync the native code update:

npx cap sync

That’s it! Pretty easy!

What’s New in V8

Version 8 of capacitor-updater brings full compatibility with Capacitor 8, ensuring your app can leverage the latest mobile OS features and improvements.

Key Updates

Capacitor 8 Compatibility: Full support for Capacitor 8’s enhanced native features
Performance Improvements: Optimized update delivery and installation process
Enhanced Stability: Bug fixes and stability improvements from v7
Maintained API Compatibility: No breaking changes to the plugin API from v7

Configuration

The configuration remains the same as v7. Your existing capacitor.config settings will continue to work:

{
  plugins: {
    CapacitorUpdater: {
      appId: 'your-app-id',
      version: '1.0.0',
      autoUpdate: true,
      // ... other settings
    }
  }
}

Migration Checklist

Follow Capacitor’s v8 migration guide, check for breaking changes.
Bump iOS minimum deployment target to 15 (required for CVE-2022-36943 fix)
Update @capgo/capacitor-updater to ^8.0.0
Run npx cap sync
Test your app thoroughly on both iOS and Android

Need Help?

If you encounter any issues during the migration, please:

Check our documentation
Visit our Discord community
Open an issue on GitHub