Revopush User guide

This 5-minute guide will help you to set up your first Revopush integration

Create an account

First, you need to create an account at the following service: https://app.revopush.org/register

Create an application

1. Go to Applications and add an application

2. Enter application name and save it

3. As a result, you will see your application in the list with two deployments available out of the box

Setup mobile client SDK

First, you need to decide what client SDK to use. We support two options:

• If you use React Native <0.76 and old architecture, you should stay on a Microsoft CodePush client SDK. Read here how to configure Microsoft CodePush SDK.

• If you need React Native >=0.76, or you need support for New Architecture, you need to use Revopush client SDK. Read here how to configure Revopush SDK.

React Native version(s)	Supporting CodePush version(s)
<v0.76	Use old Microsoft CodePush client
v0.76, v0.77, 0.78	Use Revopush SDK (Support both New and Old Architectures)

For this guide we will use Revopush SDK

Install Revopush client:

npm install --save @revopush/react-native-code-push

Setup iOS

Go to the ios/[ProjectName]/AppDelegate.swift and replace:

override func bundleURL() -> URL? {
#if DEBUG
    RCTBundleURLProvider.sharedSettings().jsBundleURL(forBundleRoot: "index")
#else
    Bundle.main.url(forResource: "main", withExtension: "jsbundle") 
    CodePush.bundleURL() 
#endif
}

Setup Android

Go to the android/app/build.gradle and add:

apply plugin: "com.android.application"
apply plugin: "org.jetbrains.kotlin.android"
apply plugin: "com.facebook.react"

apply from: "../../node_modules/@revopush/react-native-code-push/android/codepush.gradle"

Then apply changes to MainApplication.kt in the android/app/src/main/../MainApplication.kt

import com.facebook.react.soloader.OpenSourceMergedSoMapping
import com.facebook.soloader.SoLoader

import com.microsoft.codepush.react.CodePush 

class MainApplication : Application(), ReactApplication {

  override val reactNativeHost: ReactNativeHost =
      object : DefaultReactNativeHost(this) {
        override fun getPackages(): List<ReactPackage> =
            PackageList(this).packages.apply {}

        override fun getJSBundleFile(): String { 
            return CodePush.getJSBundleFile()
        }

        override fun getJSMainModuleName(): String = "index"
      }
}

After you configure your React Native application go to app settings to get Deployment keys:

Setup deployment key for iOS

Add the CodePushServerURL and CodePushDeploymentKey to the file ios/[ProjectName]/Info.plist

<key>CodePushServerURL</key>
<string>https://api.revopush.org</string>
<key>CodePushDeploymentKey</key>
<string>YOUR_DEPLOYMENT_KEY</string>

Setup deployment key for Android

Add the CodePushServerUrl and CodePushDeploymentKey to the file android/app/src/main/res/values/strings.xml

<resources>
    <string moduleConfig="true" name="CodePushServerUrl">https://api.revopush.org</string>
    <string moduleConfig="true" name="CodePushDeploymentKey">YOUR_DEPLOYMENT_KEY</string>
</resources>

JS configuration

Configure the SDK in the JavaScript layer of your app (minimal setup):

import codePush from "@revopush/react-native-code-push";

class MyApp extends Component {}

MyApp = codePush(MyApp);

More details: JS SDK API

Configure CLI

After registration, install the Revopush CLI.

npm install -g @revopush/code-push-cli

Login to Revopush CLI using the following command:

revopush login

This will launch a browser, asking you to authenticate with either your GitHub or Google account. This will generate an access key that you need to copy/paste into the CLI (it will prompt you for it). You are now successfully authenticated and can safely close your browser window.

Opening your browser...
Visit https://app.revopush.org/cli-login?hostname=<YOUR_HOST_NAME> and enter the code

Enter your access key:

Read more about Revopush CLI

Make a release

In the root folder of a React Native project, run these commands

revopush release-react <APPLICATION_NAME> ios -d <DEPLOYMENT_NAME>

revopush release-react <APPLICATION_NAME> android -d <DEPLOYMENT_NAME>

Read more about Releases in Releasing updates guide

App Center Migration

If you migrate your applications from App Center follow our step-by-step guide.