General

Plugin throws "You are trying to setup RetenoSDK without any props"

The plugin requires a configuration object. You can configure only the platform you need.

[
  "expo-reteno-sdk",
  {
    "ios": {
      "sdkAccessToken": "...",
      "mode": "production",
      "notificationService": "apns",
      "appGroups": ["group.com.your.bundleid.reteno-local-storage"],
      "config": {}
    },
    "android": {
      "sdkAccessToken": "..."
    }
  }
]

Plugin changes not applied after updating SDK or plugin props

If native code does not reflect your latest app.json config after updating expo-reteno-sdk, run prebuild with --clean to regenerate native projects from scratch:

npx expo prebuild --clean

This removes ios/ and android/ folders and recreates them. Make sure any manual native changes are backed up or managed via config plugins.

SDK does not work in Expo Go

expo-reteno-sdk uses native modules and cannot run in Expo Go. Use development build or bare workflow.

npx expo run:ios
# or
npx expo run:android

iOS

EAS Build fails on iOS extension signing/provisioning

If cloud build fails for NotificationServiceExtension / NotificationContentExtension, add extra.eas.build.experimental.ios.appExtensions to Expo config (for both targets).

See setup section:

Expo/SetupGuide/IOS.md -> EAS Build (important for iOS extensions)

Expo references:

Build fails: Missing required `mode` key

mode is required in iOS plugin config:

"ios": {
  "sdkAccessToken": "...",
  "mode": "production",
  "notificationService": "apns",
  "appGroups": ["group.com.your.bundleid.reteno-local-storage"],
  "config": {}
}

Use development for debug/simulator, production for TestFlight/App Store.

See SetupGuide for the full list of required and optional props.

Build fails: SDK token is not defined

sdkAccessToken is missing in iOS config. Add it to plugin props.

Push notifications not received on device

Enable Push Notifications capability in Xcode.
Verify mode matches current build type.
Ensure Reteno.registerForRemoteNotifications() is called at app startup.

`NotificationServiceExtension` already exists warning

NotificationServiceExtension already exists in project. Skipping... during prebuild is expected if extension already exists.

Development Team not set, code signing fails

Set devTeam with your Apple Team ID:

"ios": {
  "devTeam": "XXXXXXXXXX"
}

Firebase on iOS: build errors with modular headers

If using notificationService: "firebase", run:

cd ios && pod install --repo-update

`setDeviceToken` throws on Android

setDeviceToken is iOS-only. Guard by platform.

Android

Plugin skips `build.gradle` configuration (Kotlin DSL warning)

Auto-configuration supports Groovy build.gradle. For Kotlin DSL (.gradle.kts) configure dependencies manually.

Build fails: `minSdkVersion` too low

Reteno Android SDK requires minSdkVersion 26.

{
  "expo": {
    "android": {
      "minSdkVersion": 26
    }
  }
}

Push notifications not received on Android

Verify google-services.json is located at android/app/google-services.json.
Ensure Reteno.registerForRemoteNotifications() is called.
Verify sdkAccessToken value.