Ctrlk
HomeCreator GuideIntegration GuideReference
For the complete documentation index, see llms.txt. This page is also available as Markdown.

React Native

v0.3.2

Fixes:

  • Single-entry parameters: Resolved a bug where single-entry configuration parameters were not being passed through to experiences on Android.

  • Disabled event coalescing for message dispatch: React Native can merge consecutive events of the same type from the same view and keep only the latest one. Under rapid interaction, such as quiz taps or queued video flushes, that dropped intermediate messages before they reached the parent. Message events now bypass coalescing so every payload is delivered.

v0.3.1

Changes:

  • onMessageReceived is now fully typed. The following types are exported from @monterosa-sdk/react-native: MonterosaMessageEvent for use as the handler parameter:

    • MonterosaSdkNativeEvent as a discriminated union on nativeEvent.type.

    • MonterosaExperienceEventPayload and MonterosaIdentifyEventPayload for experience and auth event payloads respectively.

    • MonterosaExperienceMessagePayload for experience messages.

    • MonterosaSdkError as a shared error shape.

    • MonterosaSdkConfiguration which was previously inlined but is now exported directly from the package.

Improvements:

  • Bumped Android SDK version to v0.17.1

v0.3.0

Changes:

  • didShareRequest renamed to didRequestShare: The share event callback has been renamed for consistency. Update your onMessageReceived handler to listen for didRequestShare instead of didShareRequest.

  • didRequestShare is now an event type instead of message .

Improvements:

  • Bumped iOS SDK version to v0.17.0

  • Bumped Android SDK version to v0.17.0

Migration Guide

Minimum iOS version updated

The minimum supported iOS version is now iOS 15.0. Minimum Android API updated

The minimum supported version is now Android API 24

v0.2.10

New:

  • Share tray support: The SDK now surfaces share requests from experiences via the didRequestShare delegate, enabling native share sheet integration

Improvements:

  • Bumped iOS SDK version to v0.16.21

  • Bumped Android SDK version to v0.16.19

Fixes:

  • Inline media playback: Fixed allowsInlineMediaPlayback configuration option for iOS.

v0.2.9

New:

  • Allows popup behaviour in Experience: The SDK now facilitates popup windows within your Experience. This is ideal for scenarios requiring secondary windows and is triggered using the JavaScript window.open() function (or equivalent variants).

  • Allows inline video playback in Experience WebViews: The SDK now extends the WebView configuration on iOS to allow inline media playback within your Experience (allowsInlineMediaPlayback). This is useful when you want video to play embedded in-page instead of forcing fullscreen.

Migration Guide

Minimum iOS version updated

The minimum supported iOS version is now iOS 14.0.

v0.2.8

This update addresses a didFailLoading error verbosity issue on Android and upgrades SDK dependencies.

Fixes:

  • Enhanced error handling for didFailLoading to specifically address experiences not loading correctly.

Improvements:

  • Bumped iOS SDK version to v0.16.18

  • Bumped Android SDK version to v0.16.17

v0.2.7

This release resolves a Kotlin compatibility issue encountered when using Expo 53.

Fixes:

  • Fixed a Kotlin version mismatch causing build issues with Expo 53

Improvements:

  • Bumped iOS SDK version to v0.16.17

  • Bumped Android SDK version to v0.16.15

v0.2.6

This release upgrades the SDK dependencies and improves platform compatibility, and introduces background customisation.

New:

  • Background customisation: You can now customize the background of an Experience, including the loading screens and WebView background, through the ExperienceConfiguration.

Improvements:

  • Bumped iOS SDK version to v0.16.15

  • Bumped Android SDK version to v0.16.14

v0.2.5

This release resolves a class cast exception that was causing crashes on Android.

Fixes:

  • Class exception: Fixed a ClassCastException on Android to improve app stability and prevent runtime crashes.

v0.2.4

This release upgrades the SDK dependencies and improves platform compatibility.

Improvements:

  • Bumped iOS SDK version to v0.16.13

  • Bumped Android SDK version to v0.16.13

v0.2.2

Migration Guide

Dropped support for iOS 11 and iOS 12

Support for iOS 11 and 12 has been dropped, as Xcode 15 drops support for iOS 11 and the Monterosa / Interaction SDK iOS is increasing its minimum supported OS to iOS 13 to benefit from more modern Swift features.

To adopt this version, you'll need to:

  • Update package.json to 0.2.2

  • Update the version for Monterosa / Interaction SDK in your Podfile to 0.16.11

  • Update your app's minimum supported OS to at least iOS 13. This needs to be updated:

    • In the app's target in your Project file.

    • In the Podfile by updating the line:

Last updated