Migrate from 1.x to 2.x
Learn about migrating from Sentry Capacitor SDK 1.x to 2.x
Version 2 of the Sentry Capacitor SDK primarily introduces API cleanup and version support changes.
This update contains behavioral changes that will not be caught by type checkers, linters, or tests, so we recommend carefully reading through the entire migration guide instead of relying on automatic tooling.
Version 2 of the SDK is compatible with Sentry self-hosted versions 24.4.2 or higher (unchanged from v1). Lower versions may continue to work, but may not support all features.
In preparation for v2 of the OpenTelemetry SDK, the minimum required TypeScript version is increased to version 5.0.4.
- Capacitor version 2 depends on Sentry JavaScript SDK version 9. We recommend reading below migration guide docs to find out how to address any breaking changes when upgrading the sibling SDKs.
Important
To prevent issues, use fixed versions of Sentry Capacitor and the Sibling SDK. Always install the Sibling SDK version that matches Sentry Capacitor.
Each Sibling SDK has specific changes in version 9. Follow the tutorials below to update the SDK.
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").