Troubleshooting
If you see the following error during build time, the sibling SDKs installed in your app have mismatched versions:
node_modules/@sentry/types/types/globals.d.ts:2:11 - error TS2451: Cannot redeclare block-scoped variable '__DEBUG_BUILD__'.
To avoid any issues when installing packages or using the code on another machine, you must use the same version of Sentry Capacitor and @Sentry/Angular (or any other sibling SDK) that is referenced by the peer dependency of Sentry Capacitor in your app.
Correct:
"@sentry/angular": "7.13.0",
"@sentry/capacitor": "0.10.1"
Incorrect:
"@sentry/angular": "^7.13.0",
"@sentry/capacitor": "^0.10.1"
You can check which version of the sibling SDK is installed using the following command: npm info @sentry/capacitor peerDependencies
.
Capacitor 3 has a minimum requirement of iOS 12.0. As a result, the Sentry SDK needs to match this requirement to support Capacitor 3. Users on older versions may run into an error similar to:
Specs satisfying the SentryCapacitor (from ../../node_modules/@sentry/capacitor) dependency were found, but they required a higher minimum deployment target.
You can fix this by bumping your iOS deployment target. Add the snippet below to your capacitor.config.json
:
// capacitor.config.json
{
"ios": {
"minVersion": "12.0"
}
}
Then update your iOS settings:
npx cap sync
Check if you added SentryCapacitor
to the bridge. This step is required for Capacitor 2 and optional on Capacitor 3. (It's only required if you are initializing other plugins using the old method. If so, we recommend you use registerPlugin
instead of the deprecated code for initializing plugins.)
import io.sentry.capacitor.SentryCapacitor;
public class MainActivity extends BridgeActivity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// Capacitor 3
registerPlugin(SentryCapacitor.class);
// Capacitor 2
this.init(savedInstanceState, new ArrayList<Class<? extends Plugin>>() {{
add(SentryCapacitor.class);
}});
}
}
If you encounter the following error:
CocoaPods could not find compatible versions for pod "Sentry"
You can fix this by udating your pod repository:
pod repo update
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").