Force and skip

Use this page to decide who must update and who may wait.

• A soft update can be postponed with Later or skipped for good.
• A forced update can be neither. The user must update to keep using the app.

A forced update: a red badge, and only the Update button.

Make an update forced

Add one of these options to <UpdatePrompt />:

A minimum version is the oldest version you still allow. Use it when an old build breaks, for example when your server dropped an API. Use required when you want everyone on the newest build.

import { UpdatePrompt } from '@axonpack/in-app-updates';
import { Text, View } from 'react-native';

export default function App() {
  return (
    <View style={{ flex: 1 }}>
      <Text>My app</Text>
      {/* Major releases are mandatory. Smaller ones can be skipped. */}
      <UpdatePrompt required="major" />
    </View>
  );
}

Your own server can also say "required": true in its JSON. See Providers.

Skip this version

Skip this version hides the prompt for that exact version. When a newer version comes out, the prompt returns.

• A forced update can never be skipped.
• canSkip={false} removes the button from soft updates.
• Later hides the prompt only until the next start.

By default a skip is remembered until the app restarts. To keep it for good, give skipStorage something that can save a string. AsyncStorage works as it is:

import AsyncStorage from '@react-native-async-storage/async-storage';
import { UpdatePrompt } from '@axonpack/in-app-updates';
import { Text, View } from 'react-native';

export default function App() {
  return (
    <View style={{ flex: 1 }}>
      <Text>My app</Text>
      <UpdatePrompt skipStorage={AsyncStorage} />
    </View>
  );
}

skipStorage is any object with getItem and setItem, so MMKV adapters and localStorage fit too. It saves one string under axonpack.in-app-updates.skip. skipStorageKey changes that name.

How big is the update?

The result has updateType: major, minor, patch, prerelease, build or none. build means the same version with a higher build number. To ignore small differences, set depth. For example, depth: 2 compares only the first two numbers, so 1.2.9 and 1.2.0 count as equal.

Next: Providers