Installation

Install Core Package

npm

Install with npm

npm install @ramper-v2/native-core

pnpm

yarn

Install Peer Dependencies

npm

Install with npm

npm install query-string react-native-keychain react-native-inappbrowser-reborn @react-native-community/clipboard @react-navigation/bottom-tabs @react-navigation/native @react-navigation/stack accordion-collapse-react-native date-fns react-native-raw-bottom-sheet react-query react-native-gesture-handler react-native-safe-area-context react-native-screens

pnpm

yarn

Note: Follow the further installation steps of react-native-inappbrowser-reborn & react-navigation.

IOS setup

Setup Podfile for iOS

cd ios && pod install

Secondly, our SDK uses deep links to communicate back with your application. In order to Configure Deep Links, you will need to get an app id by signing up at the developer page.

After getting the app id, add the below code in your AppDelegate.m file:

AppDelegate.m

// Add the header at the top of the file:
#import <React/RCTLinkingManager.h>
 
// Add this above `@end`:
- (BOOL)application:(UIApplication *)application
   openURL:(NSURL *)url
   options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
  return [RCTLinkingManager application:application openURL:url options:options];
}

Copy your bundle id as shown in the below screenshot:

Bundle Id

Paste your bundle id in the identifier section and add ramper<appId> in the URI Scheme section: Make sure to not include the brackets <> in the URLScheme:

Android setup

Add the following in your <your-project-path>/android/app/src/main/AndroidManifest.xml file under Activity Tag

Setup deep link for Android platform

  <intent-filter>
  <!--  Make sure to not include the brackets <> in the scheme -->
    <data android:scheme="ramper<appId>" />
    <action android:name="android.intent.action.VIEW"/>
    <category android:name="android.intent.category.DEFAULT"/>
    <category android:name="android.intent.category.BROWSABLE"/>
  </intent-filter>

Run the app

iOS

Run the app for iOS

npx react-native run-ios

Android