Hot Updater
Guide
Guide

Simulate Release Mode

Since hot-updater does not work in dev environment, you need to test it in Release mode as shown below.

Checklist

  • Make sure hot-updater.config.ts is properly configured.
  • Make sure HotUpdater.wrap is properly implemented.

Step 1: Simulator Release Mode

Use the commands below to simulate downloading from the app store. Running in Release mode will lock the bundle to your current code.

iOS
Android
cd ios && pod install && cd ..
npm
pnpm
yarn
npx react-native run-ios --mode Release

Step 2: Deploy

Deploy with interactive mode and force update flag enabled in hot-updater deploy mode.

When HotUpdater.wrap is set up, updates will be applied either when you restart the app or call HotUpdater.runUpdateProcess.

You can check the update progress status using useHotUpdaterStore.

For Normal Deployment

This is the standard deployment mode. After an update is created, users need to restart their app after downloading the bundle for the update to take effect.

npm
pnpm
yarn
npx hot-updater deploy -i

For Emergency Deployment

This is the emergency deployment mode. After an update is created, the bundle will automatically reload and apply the update as soon as users download it.

npm
pnpm
yarn
npx hot-updater deploy -i --force-update

Step 3: Rollback

When you set a bundle's enabled status to false in the console, users who have that bundle will immediately force update to the previous bundle.

Open the console and set the bundle's enabled status to false.

npm
pnpm
yarn
npx hot-updater console