expo-ota-manager

A helper plugin to manage Over-The-Air updates when your app is running

This library is designed to help keep your Expo application up to date.

The default initialised value for fallbackToCacheTimeout is 0s, which means that your app will be on an old JS bundle version until the first full app restart.

When you instantiate this library it will check for new app updates every time your app opens from the background. If there are any new updates available, it will download them in the background and then prompt the user to restart their app to use the new version.

Attention!

Since version 1.1.4 expo-updates is now a peer dependency. This means you must install expo-updates with expo install expo-updates before the package will work.

Usage

yarn add expo-ota-manager

import * as React from "react";
import { Text, View, StyleSheet } from "react-native";
import { initialiseOtaManager } from "expo-ota-manager";

export default function App() {
  React.useEffect(
    () =>
      initialiseOtaManager({
        /*options*/
      }),
    []
  );

  return (
    <View style={styles.container}>
      <Text style={styles.paragraph}>
        Publish a new OTA update and open app from background to get notified
      </Text>
    </View>
  );
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: "center",
    backgroundColor: "#ecf0f1",
    padding: 8,
  },
  paragraph: {
    margin: 24,
    fontSize: 18,
    fontWeight: "bold",
    textAlign: "center",
  },
});

Available props

Name	Type	Default	Description
noButtonText	string	"Not now"	No button text
yesButtonText	string	"Restart"	Yes button text
titleText	string	"A new version is available"	Title text
textLines	string[]	["An update is ready", "Restart your app to start using it"]	The text that will appear in the alert
repromptIntervalMs	number	hourInMS	How often to remind a user to restart for an update
foregroundCheckIntervalMs	number	0 (don't run)	Time interval for an additional check that runs constantly - if you are concerned about app not going into background