This is a comprehensive list of the breaking changes introduced in the major version releases.
The plugin now uses native SQLite for Electron via the node:sqlite module. This change improves performance and reliability when using the plugin in Electron applications. Please note that this change may require you to migrate your existing databases if you were previously using the web implementation which relied on SQLite WASM and OPFS (Origin Private File System).
The minimum required version of @sqlite.org/sqlite-wasm is now 3.51.2-build2. This version includes a new distribution structure that requires the following changes:
- The asset input path has changed from
node_modules/@sqlite.org/sqlite-wasm/sqlite-wasm/jswasm/tonode_modules/@sqlite.org/sqlite-wasm/dist/. - The worker file has been renamed from
sqlite3-worker1-bundler-friendly.mjstosqlite3-worker1.mjs.
This plugin now supports Capacitor 8. The minimum Android SDK version is 24 and the iOS deployment target is 15.0. Ensure your project meets these requirements before upgrading.
The @sqlite.org/sqlite-wasm dependency version is now restricted to 3.50.3-build1 or lower. Versions higher than 3.50.3-build1 are not supported due to an open bug report (see sqlite/sqlite-wasm#123).
- On Android, the
androidxSqliteVersionvariable has been updated to2.6.2. - On Android, the
androidxSqliteFrameworkAndroidVersionvariable has been updated to2.6.2. - On Android, the
netZeteticSqlcipherVersionvariable has been updated to4.12.0.
The default behavior for setting the database version has changed. If neither version nor upgradeStatements are provided when opening a database, no version will be set. This allows for greater flexibility in managing database versions manually. Previously, if you did not specify a version when opening a database, the default version was set to 1.