跳转到内容
Capgo - Live Updates for Capacitor Apps Capgo

Migrate from Ionic Secure Storage

此内容尚不支持你的语言。

Ionic Secure Storage is an enterprise plugin for encrypted key-value data. Capgo provides two SQLite-based options depending on your data model and performance needs.

Capgo replacements at a glance

Section titled “Capgo replacements at a glance”
Ionic enterprise pluginCapgo replacementMigration guide
Secure Storage@capgo/capacitor-fast-sql or @capgo/capacitor-data-storage-sqliteYou are here
Auth Connect@capgo/capacitor-social-loginAuth Connect migration
Identity Vault@capgo/capacitor-native-biometricIdentity Vault migration

Choose your storage plugin

Section titled “Choose your storage plugin”
  • Fast SQL: Best for large datasets, sync workflows, or when you want full SQL control and high throughput.
  • Data Storage SQLite: Best for simple key-value storage with optional encryption and minimal setup.

If you are unsure, start with Data Storage SQLite for key-value secrets and move to Fast SQL when you need structured data or high-volume writes.

Migration steps

Section titled “Migration steps”
  1. Pick the storage plugin that matches your data model.
  2. Install the plugin and sync native code.
Terminal window
# Option A: Fast SQL
npm install @capgo/capacitor-fast-sql


# Option B: Data Storage SQLite
npm install @capgo/capacitor-data-storage-sqlite


npx cap sync
  1. Update storage calls to the new API surface. Use the Fast SQL or Data Storage SQLite docs for the exact read/write methods.
  2. Migrate existing data on first launch by reading values from Ionic Secure Storage and writing them into the new SQLite store.
  3. Remove Ionic Secure Storage from your dependencies and native configuration.

Next steps

Section titled “Next steps”