Integrate Whatfix Mobile SDK with React Native iOS

To create Whatfix Mobile in-app experiences on your React Native apps, you need to first set up Whatfix Mobile. You can add the Whatfix Mobile SDK provided for React Native apps to the source code of your app and then create and publish content.

• Prerequisites
• Integration steps for React Native iOS app

Prerequisites

• API Key
• Add tags to views. For more information, see tag views.
• Whatfix Mobile React Native SDK is incompatible with managed workflow. If you are using expo to start your react-native project, make sure to eject to the bare workflow.
• The minimum deployment target of Whatfix Mobile SDK is iOS 10. But Whatfix Mobile works only for devices running on iOS 11 and above.

Integration steps for React Native iOS app

Use the following steps to integrate the Whatfix Mobile SDK with your React Native iOS project:

Step 1: Integrate Whatfix Mobile SDK

a. Add the Whatfix Mobile SDK dependency

Download the leap-react-native package from npm using the following command:

// Using npm
npm install leap-react-native@2.0.5 --save

// Using yarn
yarn add leap-react-native@2.0.5

cd ios && pod install

// To update Leap iOS SDK once installed, run the following command
pod update

b. Start the Whatfix Mobile SDK

To start Whatfix Mobile, add the following code inside componentDidMount() {} in your App.js file.

import LeapReactNative from 'leap-react-native';

export class App extends React.Component {
	componentDidMount() {
		Platform.select({
			ios: () => LeapReactNative.start('API_KEY')
		})()
	}
}

Step 2: Enable Creator mode in your app

To create in-app experiences in the Whatfix Mobile Studio, you have to enable the Creator mode in your app. This is done by integrating the Whatfix Mobile Creator SDK.

a. Add dependencies

Download the leap-creator-react-native package from npm using the following command:

// Using npm
npm install leap-creator-react-native@2.0.5 --save

// Using yarn
yarn add leap-creator-react-native@2.0.5

cd ios && pod install

// To update Leap creator iOS SDK once installed, run the following command
pod update

b. Start the Whatfix Mobile Creator SDK

To start the Whatfix Mobile Creator, add the following code inside componentDidMount() {} in your App.js file.

import LeapCreatorReactNative from 'leap-creator-react-native';

export class App extends React.Component {
	componentDidMount() {
		Platform.select({
			ios: () => LeapCreatorReactNative.start('API_KEY'),
		})()
	}
}

After integrating the code, you can start creating your in-app experience using Whatfix Mobile.