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>

Note: Need to use @import CleverTapSDK; instead of #import <CleverTapSDK/CleverTap.h> and @import CleverTapReact; instead of #import <CleverTapReact/CleverTapReactManager.h> in the AppDelegate class in case if using use_modular_headers! in the podfile.

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;

   import com.clevertap.android.sdk.CleverTapAPI;
   
   
   //...
   
   // add CleverTapPackage to react-native package list
   @Override
     protected List<ReactPackage> getPackages() {
       List<ReactPackage> packages = new PackageList(this).getPackages();

       // Packages that cannot be autolinked yet can be added manually here, for

       // example:

       packages.add(new CleverTapPackage());// only needed when not auto-linking
       return packages;
   
   // ...
   
   // 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;
   import android.os.Bundle;
   
   public class MainActivity extends ReactActivity {
   	// ...
   
   	@Override
   	protected void onCreate(Bundle savedInstanceState) {
       	super.onCreate(savedInstanceState);
       	CleverTapModule.setInitialUri(getIntent().getData());
   	}
   
       // ...
   }

see the included Example Project