React Native SDK

This document describes how to set up the React Native wrapper bridge using Hydra Native SDKs.

To use Capillary Engagement platform on React Native application, you need to set up the React Native Wrapper using the Native Hydra Android and iOS SDKs.

Requirements

Android

  • Minimum Android SDK version - 21
  • Minimum compileSdkVersion - 34
  • Supported targetSdkVersion - 34
  • Minimum Android Gradle Version - 7.2.2
  • Minimum Kotlin version - 1.7.10

iOS

  • Minimum iOS SDK version - 14.3+

Prerequisites

To start integrating and accessing the Hydra SDK, you need -

  1. Capillary Account access with account Id, base url, and sslPublicKey
  2. Private Github Hydra Maven package access for Android and iOS

Client team will need to share following information to Hydra team -

  1. App bundle id for both Android and iOS (extracted by client app)
  2. App signature (extracted by client app)

Getting App Bundle Ids

Android - Go to android/app/build.gradle file and copy applicationId
iOS - Open XCode, click on Project target -> General settings -> Copy Bundle Id

Getting App Signature

For Android, Capillary requires App’s signatures for Debug and Release certificates. Here is how you can extract the app signatures -

From terminal -

If you have keytool installed, then you can use following commands -

keytool -list -v -keystore PATH_TO_KEYSTORE -alias VALUE_OF_ALIAS

Copy the SHA256 string from the output:

SHA256: LOOK_FOR_THIS_VALUE

From Android Studio -

gradle -> app -> Tasks -> android -> signingReport

Copy the SHA256 string from the output:

SHA256: LOOK_FOR_THIS_VALUE

Native Hydra Packages

Hydra SDK supports following packages -

  1. Hydra Core - This is the core Hydra package which is used to initialize Hydra SDK and expose behavioral events (signUp, signIn, pushEvents etc)
  2. Hydra Push Base - Base Push notification package
  3. Hydra Firebase - Hydra Firebase package for push notifications using Firebase
  4. Hydra Rich Notification - Package for Rich Notification support in Android
  5. Hydra InApp - Hydra package for In App messaging support
  6. Hydra Inbox Core - Hydra package for Notification Center Support APIs
  7. Hydra Inbox UI - Hydra package for Notification Center Support with UI
  8. Hydra Push Notification Extension (iOS only) - Push notification extension for iOS

Demo App

We have also create a Sample React native application to demonstrate how to integrate these packages in the React Native application, please contact Capillary support team to get the access