HotupdaterHot Updater
React Native API

isUpdateDownloaded

Returns whether an update bundle has finished downloading in the current app session and is ready to be applied on reload.

Usage

  • Returns true when the download progress has reached 1.0.
  • Returns false while downloading or before any download starts.
  • Resets to false automatically when a new download starts.
import { hotUpdater } from "./hotUpdater";

async function maybeApplyUpdate() {
  if (hotUpdater.isUpdateDownloaded()) {
    await hotUpdater.reload();
  }
}

Skip checkForUpdate when a download already exists

If a bundle has already finished downloading in this session, you can skip checkForUpdate() and just prompt the user to reload.

import { hotUpdater } from "./hotUpdater";

async function checkAndUpdate() {
  // Avoid network call if an update is already downloaded and awaiting reload
  if (hotUpdater.isUpdateDownloaded()) {
    // e.g., show a "Restart to update" CTA or reload immediately
    return;
  }

  const updateInfo = await hotUpdater.checkForUpdate({
    updateStrategy: "appVersion", // or "fingerprint"
    // requestHeaders: { "x-api-key": "<your-api-key>" },
  });

  if (!updateInfo) return;

  const ok = await updateInfo.updateBundle();
  if (!ok) return;

  if (updateInfo.shouldForceUpdate) {
    await hotUpdater.reload();
  }
}

Details

  • This value is derived from the internal progress state managed by useHotUpdaterStore().
  • It is session-scoped: it does not persist across app restarts.
  • Transitions that need no download, USE_BUILTIN and ADOPT_RELEASE, leave it false. Use the result of the selected updateBundle() helper to confirm those transitions succeeded.
  • Use this when you need to decide whether to show a "Restart to update" UI or trigger a controlled reload.
import { useHotUpdaterStore } from "@hot-updater/react-native";
import { Button } from "react-native";

import { hotUpdater } from "./hotUpdater";

export function UpdateButton() {
  const { progress, isUpdateDownloaded } = useHotUpdaterStore();
  return (
    <Button
      title={
        isUpdateDownloaded
          ? "Restart to update"
          : `Updating... ${Math.round(progress * 100)}%`
      }
      onPress={() => hotUpdater.reload()}
      disabled={!isUpdateDownloaded}
    />
  );
}

addListener

Subscribe to Hot Updater events.

getAppVersion

The `hotUpdater.getAppVersion()` function returns the current native app version embedded at build time.

On this page

UsageSkip checkForUpdate when a download already existsDetails