---
title: "Troubleshooting"
description: "Troubleshoot and resolve common issues with the Capacitor SDK."
url: https://docs.sentry.io/platforms/javascript/guides/capacitor/troubleshooting/
---

# Troubleshooting | Sentry for Capacitor

## [Replay only shows a white Empty page](https://docs.sentry.io/platforms/javascript/guides/capacitor/troubleshooting.md#replay-only-shows-a-white-empty-page)

Session Replay does not work correctly with `@ionic/angular`, `@ionic/vue`, or `@ionic/react` version `8.7.1` or newer. Pin these packages to version `8.7.0` to capture session replays.

## [Support 16 KB Page Sizes on Android](https://docs.sentry.io/platforms/javascript/guides/capacitor/troubleshooting.md#support-16-kb-page-sizes-on-android)

Starting with Android 15, AOSP supports devices with a 16 KB page size. If your app uses NDK libraries (directly or via an SDK), you'll need to rebuild it for compatibility with these devices.

Update to Sentry Capacitor SDK version `1.5.0` and above order to support 16 KB page sizes on Android devices.

Please read the [Android developer documentation](https://developer.android.com/guide/practices/page-sizes) to update and test your app with 16 KB page size support.

## [Different Versions for Sibling SDKs](https://docs.sentry.io/platforms/javascript/guides/capacitor/troubleshooting.md#different-versions-for-sibling-sdks)

If you see the following error during build time, the sibling SDKs installed in your app have mismatched versions:

```javascript
  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:

```xml
    "@sentry/angular": "7.13.0",
    "@sentry/capacitor": "0.10.1"
```

Incorrect:

```xml
    "@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 2 on iOS](https://docs.sentry.io/platforms/javascript/guides/capacitor/troubleshooting.md#capacitor-2-on-ios)

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`:

```json
// capacitor.config.json
{
  "ios": {
    "minVersion": "12.0"
  }
}
```

Then update your iOS settings:

```bash
npx cap sync
```

## [Capacitor on Android](https://docs.sentry.io/platforms/javascript/guides/capacitor/troubleshooting.md#capacitor-on-android)

### [No events sent](https://docs.sentry.io/platforms/javascript/guides/capacitor/troubleshooting.md#no-events-sent)

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.)

```java
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);
    }});
  }
}
```

## [Capacitor on iOS](https://docs.sentry.io/platforms/javascript/guides/capacitor/troubleshooting.md#capacitor-on-ios)

### [Capacitor sync failing](https://docs.sentry.io/platforms/javascript/guides/capacitor/troubleshooting.md#capacitor-sync-failing)

If you encounter the following error:

```bash
CocoaPods could not find compatible versions for pod "Sentry"
```

You can fix this by updating your pod repository:

```bash
pod repo update
```