react-native-ota-hot-update

The OTA update process follows this lifecycle:

1. Download & Install: The app fetches an update.json from your server/Git. If a new version is found, it downloads bundle.zip. The native module unzips this to a versioned folder and saves the path to local storage (SharedPrefs/UserDefaults).
2. App Startup: When the app starts, the native module checks local storage for a saved OTA bundle path. If a valid path exists and the file is on disk, it loads the OTA bundle. Otherwise, it falls back to the built-in bundle.
3. Crash Auto-Rollback: If the app crashes within 2 seconds of starting with a new bundle, the native module automatically restores the previous bundle path and restarts the app with the safe version.

The experimental 2.4.0-rc.1 release introduces advanced bundle lifecycle management.

Key Features:

• Configurable bundle history: Use maxBundleVersions to limit how many versions are kept.
• Automatic cleanup: Older bundles are removed automatically when the limit is reached.
• New APIs:
  • getBundleList(): Retrieve available bundles.
  • deleteBundleById(): Remove a specific bundle.
  • clearAllBundles(): Wipe all downloaded bundles.

To install the preview version:

yarn add react-native-ota-hot-update@2.4.0-rc.1

After making changes to your code (e.g., in App.tsx), use the following shortcuts to reload the app and see your changes:

• Android: Press the <kbd>R</kbd> key twice, or open the Developer Menu (<kbd>Ctrl</kbd> + <kbd>M</kbd> on Windows/Linux, or <kbd>Cmd ⌘</kbd> + <kbd>M</kbd> on macOS) and select "Reload".
• iOS: Press <kbd>Cmd ⌘</kbd> + <kbd>R</kbd> within the iOS Simulator.

For standard iOS projects using Objective-C, modify AppDelegate.m to return the OTA bundle instead of the default bundle in release mode.

1. Import the header: #import "OtaHotUpdate.h"
2. Update the bundle URL logic:

```objc
#import "OtaHotUpdate.h"

// ... inside your AppDelegate methods
{
#if DEBUG
  return [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@

To use this module with Expo, add react-native-ota-hot-update to the plugins array in your app.json file.

"plugins": [
  "react-native-ota-hot-update",
  ...
]

For React Native 0.77 or above where AppDelegate is a Swift file, update AppDelegate.swift to use OtaHotUpdate.getBundle() in the bundleURL() method.

import react_native_ota_hot_update

override func bundleURL() -> URL? {
    #if DEBUG
        RCTBundleURLProvider.sharedSettings().jsBundleURL(forBundleRoot: "index")
    #else
        OtaHotUpdate.getBundle()  // Add this line
    #endif
}

For Android projects using Java, override getJSBundleFile() in MainApplication.java.

@Nullable
@Override
protected String getJSBundleFile() {
    return OtaHotUpdate.getJSBundle(this);
}

For standard Android projects using Kotlin, override getJSBundleFile() in your MainApplication.kt to return the OTA bundle path.

import com.otahotupdate.OtaHotUpdate

// ... inside ReactNativeHost
override fun getJSBundleFile(): String? {
  return OtaHotUpdate.bundleJS(this@MainApplication)
}

Install the core package. If you need to manage download progress, you must also install react-native-blob-util.

Standard Installation:

yarn add react-native-ota-hot-update

With Download Progress Support:

yarn add react-native-ota-hot-update && yarn add react-native-blob-util

Note: Hot updates only work in release mode. They will not function in debug mode.

In React Native 0.82 or above, you must provide the bundle path to the reactHost configuration in MainApplication.kt.

override val reactHost: ReactHost by lazy {
  getDefaultReactHost(
    context = applicationContext,
    packageList = PackageList(this).packages,
    jsBundleFilePath = OtaHotUpdate.bundleJS(applicationContext)
  )
}