integration.md

Integrating the CleverTap SDK

After install, you will need to integrate the CleverTap SDK into your iOS and Android apps.

iOS

1. Follow the integration instructions starting with Step 2 here.
2. In your AppDelegate didFinishLaunchingWithOptions: notify the CleverTap React SDK of application launch:

[CleverTap autoIntegrate]; // integrate CleverTap SDK using the autoIntegrate option
[[CleverTapReactManager sharedInstance] applicationDidLaunchWithOptions:launchOptions];

NOTE: Don't forget to add the CleverTap imports at the top of the file.

#import <CleverTapSDK/CleverTap.h>
#import <CleverTapReact/CleverTapReactManager.h>

See the Example Project.

Android

1. Follow the integration instructions starting with Step 2 here.

2. Add CleverTapPackage to the packages list in MainApplication.java (android/app/src/[...]/MainApplication.java)

   // ...
   
   // CleverTap imports
   import com.clevertap.android.sdk.ActivityLifecycleCallback;
   import com.clevertap.react.CleverTapPackage;
   
   //...
   
   // add CleverTapPackage to react-native package list
   @Override
     protected List<ReactPackage> getPackages() {
       return Arrays.<ReactPackage>asList(
               new MainReactPackage(),
               new CleverTapPackage(), // <-- add this
   
   // ...
   
   // add onCreate() override
   @Override
   public void onCreate() {
      // Register the CleverTap ActivityLifecycleCallback; before calling super
     ActivityLifecycleCallback.register(this);	
     super.onCreate();
   }

3. Optionally Override onCreate in MainActivity.java to notify CleverTap of a launch deep link (android/app/src/[...]/MainActivity.java)

   import com.clevertap.react.CleverTapModule;
   
   public class MainActivity extends ReactActivity {
   	// ...
   
   	@Override
   	protected void onCreate(Bundle savedInstanceState) {
       	super.onCreate(savedInstanceState);
       	CleverTapModule.setInitialUri(getIntent().getData());
   	}
   
       // ...
   }

See the Example Project.