Taplytics React Native SDK

Taplytics is a native mobile A/B testing and push notification platform that helps you optimize your React Native app!

Commercial License / Terms

Current Version: 1.4.0

1. Getting Started

If you haven't yet set up a React-Native project, do the following:

First install node and react.

1. brew install node
2. brew install watchman
3. npm install -g react-native-cli

Then, initialize a new project.

1. react-native init projectname
2. cd projectname
3. npm install

Install the taplytics-react-native package:

1. Install taplytics-react-native npm package:
   • npm install taplytics-react-native --save
2. Then link the taplytics-react-native native module. (for iOS you will need to manually link the module to your XCode project as described below)
   • react-native link taplytics-react-native

2. iOS Setup

1. Follow the react-native manual linking native library instructions

   • project to import is located in /node_modules/taplytics-react-native/ios/RNTaplyticsReact.xcodeproj
   • you can skip step 3 of the instructions.

2. Simply follow part 1 of the install instructions to install the Native Taplytics iOS SDK. Use CocoaPods if you use it for your project or the manual install instructions. iOS SDK installation docs here.

3. Android Setup

1. Append the taplytics-react-native project settings.gradle include line:

   include 'app:', ':taplytics-react-native'

2. add the following line to settings.gradle

   project(':taplytics-react-native').projectDir = new File(rootProject.projectDir, 	'../node_modules/taplytics-react-native/android')

3. In your app-level build.gradle add the following your dependencies:

   compile project(':taplytics-react-native')
   

   Note that React Native is packaged with an older version of OkHttp, so an older version of socketio is required:

   debugCompile ('io.socket:socket.io-client:0.8.0') {
       exclude group: 'org.json', module: 'json'
   }
   

4. In your app-level build.gradle, add this the taplytics url to your repositories:

   repositories {                                                                                              
   	maven { url "https://github.com/taplytics/Taplytics-Android-SDK/raw/master/AndroidStudio/" }
   }
   

5. In your Application Class (default is MainApplication), add Taplytics to your app's packages:

   @Override
   protected List<ReactPackage> getPackages() {
     return Arrays.asList(
         new MainReactPackage(),
         new TaplyticsReactPackage()
     );
   }

6. Follow part 1. Install and part 2. Setup from the Android SDK docs here.

4. Start making Experiments and sending Push Notifications to your users.

This module wraps most native SDK methods in Javascript, allowing you to access features such as dynamic variables, code blocks and event logging in the React Native environment.

Be sure to import Taplytics into your react application:

import Taplytics from 'taplytics-react-native';

Then follow the Experiment guide and the Push Notification guide to get started.

Changelog

Current: 1.4.0

1. Added call registerPushNotifications for iOS

1.3.0

1. Changed setUserAttributes to return promise.

1.2.0

1. Added getRunningFeatureFlags and featureFlagEnabled methods.

1.1.11

1. Add push open listener compatability for cold open after force close on Android.

1.1.10

1. Push listener backwards compatibility for react native <0.50.0

1.1.8

1. Remove erroneous log

1.1.7

1. Fix registering for push on iOS

1.1.5

1. Allow for push notification hooks in iOS

1.1.4

1. Add error states for various async calls

1.1.3

1. RN 0.47+ Support

1.0.12

1. Update reference to iOS push register method.

1.0.11

1. Fixed json attributes passed into logEvent and logRevenue causing crash.

1.0.10

1. Fixed search paths for non-cocoapods import

1.0.9

1. Fixed getSessionInfo crash

1.0.8

1. Added push ID to value sent to BroadcastReceiver

1.0.7

1. Added safety in broadcastReceiver

1.0.6

1. Fixed broadcastreceiver sending wrong push event types.

1.0.5

1. Updated android package name from com.react to com.taplytics.react

1.0.4

1. Updated search paths

1.0.3

1. Fixed npm references not pointing to the right project.
2. Cleaned up many iOS functions.

1.0.1

1. Fixed react native minimum version number.

1.0.0

1. Initial version of React Native SDK. Please contact us with any questions or use git issues.