Migrating from Codepush

Introduction

Switching from Codepush to Stallion is incredibly straightforward, you won't face a steep learning curve, as the installation and integration steps remain nearly identical.

Step 1: Removig Codepush and Installing Stallion SDK

Remove Codepush SDK from your app and all the related settings, API keys, android/settings.gradle and android/app/build.gradle settings.

Install Stallion SDK. For more info check Installion Steps:

With npm:

npm install react-native-stallion

With Yarn:

yarn add react-native-stallion

Step 2: Do native changes in iOS and Android.

// ...other imports
import com.stallion.Stallion;

public class MainApplication extends Application implements ReactApplication {
  // ...rest of the class
  @Override
  protected String getJSBundleFile() {
      return Stallion.getJSBundleFile(getApplicationContext());
  }
}

// ...other imports
import com.stallion.Stallion

// ...other functions
override val reactNativeHost: ReactNativeHost =
  object : DefaultReactNativeHost(this) {
    override fun getPackages(): List<ReactPackage> =
      //other methods...

      override fun getJSBundleFile(): String? {
          return Stallion.getJSBundleFile(applicationContext)
      }
  }

  // ...other imports
  #import <react-native-stallion/StallionModule.h>

  @implementation AppDelegate
  // ...other implemetations
  - (NSURL *)sourceURLForBridge:(RCTBridge *)bridge
  {
      #if DEBUG
        return [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index"];
      #else
        return [StallionModule getBundleURL];
      #endif
  }

 import react_native_stallion

 // ...other functions
 override func bundleURL() -> URL? {
     #if DEBUG
         RCTBundleURLProvider.sharedSettings().jsBundleURL(forBundleRoot: "index")
     #else
         StallionModule.getBundleURL()
     #endif
 }

Step 3: Add projectId and token in native

• Get projectID from Stallion Dashboard : On project info page, copy project id.

• Generate App Token : On project settings page click on Generate App Token to create a new app token

Add StallionProjectId & StallionAppToken as shown below -

• iOS: Add the copied App Token and projectId to info.plist

• android: Add the copied App Token and projectId to strings.xml

Step 4: Do React Native changes

   import { withStallion } from "react-native-stallion";

   const MyApp = () => {
       // Your App.js Code
   }

   export default withStallion(MyApp);

Step 5: Upload your react-native bundle

Sign in to the Stallion Console and set up your organization and project. Within your project, create a bucket—ideally, the bucket represents the feature you’re developing, and it will house all the associated bundles.

npm install --save-dev stallion-cli

yarn add -D stallion-cli

npx stallion publish-bundle --upload-path=<orgname>/<project-name>/<bucket-name> --platform=<android/ios> --release-note="Migrated from CodePush"

Step 6: Promote your bundle

Return to the console and select the bucket where your bundle was uploaded. Then, choose the bundle you wish to promote, click on "Promote" and complete the necessary fields such as Target App Version and Release Note. Finally, click "Promote Bundle."

Initially, the bundle will be promoted but released to 0% of users. To test it, click on "Manage Release," change the rollout percentage to 100%, and then click "Update Release."

Step 7: Verifying the release

Generate a release flavor of your app to ensure that the Metro bundler doesn't override the Stallion bundle. Launch the app so that on its first run, it downloads any available released bundle. Then, restart the app to apply the changes.

With this, your migration to Stallion is complete, enabling you to instantly scale your releases to your valued users.