HomeGuidesReferenceLearn

Reference version

Expo Updates iconExpo Updates

GitHub

npm

A library that allows programmatically controlling and responding to new updates made available to your app.


The expo-updates library allows you to programmatically control and respond to new updates made available to your app.

Platform Compatibility

Android DeviceAndroid EmulatoriOS DeviceiOS SimulatorWeb

Installation

Terminal
npx expo install expo-updates

If you're installing this in a bare React Native app, you should also follow these additional installation instructions.

Configuration in app.json/app.config.js

The plugin is configured with the Expo account's username automatically when EAS CLI is used.

Example app.json with config plugin

app.json
{
  "expo": {
    "plugins": [
      [
        "expo-updates",
        {
          "username": "account-username"
        }
      ]
    ]
  }
}
Are you using this library in a bare React Native app?

Learn how to configure the native projects in the installation instructions in the expo-updates repository.

Usage

Most of the methods and constants in this module can only be used or tested in release mode. In debug builds, the default behavior is to always load the latest JavaScript from a development server. It is possible to build a debug version of your app with the same updates behavior as a release build. Such an app will not open the latest JavaScript from your development server — it will load published updates just as a release build does. This may be useful for debugging the behavior of your app when it is not connected to a development server.

To test manual updates in the Expo Go app, run eas update and then open the published version of your app with Expo Go.

To test manual updates with standalone apps, you can create a .apk or a simulator build, or make a release build locally with npx expo run:android --variant release and npx expo run:ios --configuration Release (you don't need to submit this build to the store to test).

Check for updates manually

The expo-updates library exports a variety of functions to interact with updates once the app is already running. In some scenarios, you may want to check if updates are available or not. This can be done manually by using checkForUpdateAsync() as shown in the example below:

App.js
import { View, Button } from 'react-native';
import * as Updates from 'expo-updates';

function App() {
  async function onFetchUpdateAsync() {
    try {
      const update = await Updates.checkForUpdateAsync();

      if (update.isAvailable) {
        await Updates.fetchUpdateAsync();
        await Updates.reloadAsync();
      }
    } catch (error) {
      // You can also add an alert() to see the error message in case of an error when fetching updates.
      alert(`Error fetching latest Expo update: ${error}`);
    }
  }

  return (
    <View>
      <Button title="Fetch update" onPress={onFetchUpdateAsync} />
    </View>
  );
}

Use expo-updates with a custom server

Every custom updates server must implement the Expo Updates protocol.

Custom Expo Updates Server

You can find an example implementation of a custom server and an app using that server in this GitHub repository.

Configuration options

There are build-time configuration options that control the behavior of expo-updates.

On Android, these options are set as meta-data tags adjacent to the tags added during installation in the AndroidManifest.xml file. You can also define these options at runtime by passing a Map as the second parameter of UpdatesController.overrideConfiguration(), and the provided values will override any value specified in AndroidManifest.xml.

On iOS, these properties are set as keys in the Expo.plist file. You can also set them at runtime by calling [EXUpdatesAppController overrideConfigurationWithConfiguration:] at any point before expo-updates is initialized, and the values in this dictionary will override any values specified in Expo.plist. If you tried to use the EXUpdatesAppController from the AppDelegate.mm, you will need to add the following imports:

From Objective-C to import Swift headers for expo-updates
#import "ExpoModulesCore-Swift.h"
#import "EXUpdatesInterface-Swift.h"
#import "EXUpdates-Swift.h"
iOS plist/dictionary keyAndroid Map keyAndroid meta-data nameDefaultRequired?
EXUpdatesEnabledenabledexpo.modules.updates.ENABLEDtrue
EXUpdatesURLupdateUrlexpo.modules.updates.EXPO_UPDATE_URL(none)
EXUpdatesRequestHeadersrequestHeadersexpo.modules.updates.UPDATES_CONFIGURATION_REQUEST_HEADERS_KEY(none)
EXUpdatesRuntimeVersionruntimeVersionexpo.modules.updates.EXPO_RUNTIME_VERSION(none)
EXUpdatesCheckOnLaunchcheckOnLaunchexpo.modules.updates.EXPO_UPDATES_CHECK_ON_LAUNCHALWAYS (ALWAYS, NEVER, WIFI_ONLY, ERROR_RECOVERY_ONLY)
EXUpdatesLaunchWaitMslaunchWaitMsexpo.modules.updates.EXPO_UPDATES_LAUNCH_WAIT_MS0
EXUpdatesCodeSigningCertificatecodeSigningCertificateexpo.modules.updates.CODE_SIGNING_CERTIFICATE(none)
EXUpdatesCodeSigningMetadatacodeSigningMetadataexpo.modules.updates.CODE_SIGNING_METADATA(none)
EXUpdatesCodeSigningIncludeManifestResponseCertificateChaincodeSigningIncludeManifestResponseCertificateChainexpo.modules.updates.CODE_SIGNING_INCLUDE_MANIFEST_RESPONSE_CERTIFICATE_CHAINfalse
EXUpdatesConfigCodeSigningAllowUnsignedManifestscodeSigningAllowUnsignedManifestsexpo.modules.updates.CODE_SIGNING_ALLOW_UNSIGNED_MANIFESTSfalse

For a detailed explanation, see the expo-updates repository.

API

import * as Updates from 'expo-updates';

Constants

Updates.channel

Type: string | null


The channel name of the current build, if configured for use with EAS Update. null otherwise.

Expo Go and development builds are not set to a specific channel and can run any updates compatible with their native runtime. Therefore, this value will always be null when running an update on Expo Go or a development build.

Updates.checkAutomatically

Type: UpdatesCheckAutomaticallyValue | null


Determines if and when expo-updates checks for and downloads updates automatically on startup.

Updates.createdAt

Type: Date | null


If expo-updates is enabled, this is a Date object representing the creation time of the update that's currently running (whether it was embedded or downloaded at runtime).

In development mode, or any other environment in which expo-updates is disabled, this value is null.

Updates.isEmbeddedLaunch

Type: boolean


This will be true if the currently running update is the one embedded in the build, and not one downloaded from the updates server.

Updates.isEmergencyLaunch

Type: boolean


expo-updates does its very best to always launch monotonically newer versions of your app so you don't need to worry about backwards compatibility when you put out an update. In very rare cases, it's possible that expo-updates may need to fall back to the update that's embedded in the app binary, even after newer updates have been downloaded and run (an "emergency launch"). This boolean will be true if the app is launching under this fallback mechanism and false otherwise. If you are concerned about backwards compatibility of future updates to your app, you can use this constant to provide special behavior for this rare case.

Updates.isEnabled

Type: boolean


Whether expo-updates is enabled. This may be false in a variety of cases including:

  • enabled set to false in configuration
  • missing or invalid URL in configuration
  • missing runtime version or SDK version in configuration
  • error accessing storage on device during initialization

When false, the embedded update is loaded.

Updates.manifest

Type: Partial<Manifest>


If expo-updates is enabled, this is the manifest (or classic manifest) object for the update that's currently running.

In development mode, or any other environment in which expo-updates is disabled, this object is empty.

Updates.runtimeVersion

Type: string | null


The runtime version of the current build.

Updates.updateId

Type: string | null


The UUID that uniquely identifies the currently running update. The UUID is represented in its canonical string form and will always use lowercase letters. This value is null when running in a local development environment or any other environment where expo-updates is disabled.

Example

Hooks

Deprecated. This API is deprecated and will be removed in a future release corresponding with SDK 51. Use useUpdates() instead.

useUpdateEvents(listener)

NameTypeDescription
listener(event: UpdateEvent) => void

A function that will be invoked with an UpdateEvent instance and should not return any value.


React hook to create an UpdateEvent listener subscription on mount, using addListener. It calls remove() on the subscription during unmount.

Example

function App() {
  const eventListener = (event) => {
    if (event.type === Updates.UpdateEventType.ERROR) {
      // Handle error
    } else if (event.type === Updates.UpdateEventType.NO_UPDATE_AVAILABLE) {
      // Handle no update available
    } else if (event.type === Updates.UpdateEventType.UPDATE_AVAILABLE) {
      // Handle update available
    }
  };
  Updates.useUpdateEvents(eventListener);
  // React Component...
}

Returns

  • void

useUpdates()

Hook that obtains information on available updates and on the currently running update.

Example

import { StatusBar } from 'expo-status-bar';
import * as Updates from 'expo-updates';
import { useEffect } from 'react';
import { Button, Text, View } from 'react-native';

export default function UpdatesDemo() {
  const {
    currentlyRunning,
    isUpdateAvailable,
    isUpdatePending
  } = Updates.useUpdates();

  useEffect(() => {
    if (isUpdatePending) {
      // Update has successfully downloaded
      runUpdate();
    }
  }, [isUpdatePending]);

  // If true, we show the button to download and run the update
  const showDownloadButton = isUpdateAvailable;

  // Show whether or not we are running embedded code or an update
  const runTypeMessage = currentlyRunning.isEmbeddedLaunch
    ? 'This app is running from built-in code'
    : 'This app is running an update';

  return (
    <View style={styles.container}>
      <Text style={styles.headerText}>Updates Demo</Text>
      <Text>{runTypeMessage}</Text>
      <Button onPress={() => Updates.checkForUpdateAsync()} title="Check manually for updates" />
      {showDownloadButton ? (
        <Button onPress={() => Updates.fetchUpdateAsync()} title="Download and run update" />
      ) : null}
      <StatusBar style="auto" />
    </View>
  );
}

Returns


the structures with information on currently running and available updates.

Methods

Updates.checkForUpdateAsync()

Checks the server to see if a newly deployed update to your project is available. Does not actually download the update. This method cannot be used in development mode, and the returned promise will be rejected if you try to do so.

Checking for an update uses a device's bandwidth and battery life like any network call. Additionally, updates served by Expo may be rate limited. A good rule of thumb to check for updates judiciously is to check when the user launches or foregrounds the app. Avoid polling for updates in a frequent loop.

Returns


A promise that fulfills with an UpdateCheckResult object.

The promise rejects in Expo Go or if the app is in development mode, or if there is an unexpected error or timeout communicating with the server. It also rejects when expo-updates is not enabled.

Updates.clearLogEntriesAsync()

Clears existing expo-updates log entries.

For now, this operation does nothing on the client. Once log persistence has been implemented, this operation will actually remove existing logs.

Returns


A promise that fulfills if the clear operation was successful.

The promise rejects if there is an unexpected error in clearing the logs.

Updates.fetchUpdateAsync()

Downloads the most recently deployed update to your project from server to the device's local storage. This method cannot be used in development mode, and the returned promise will be rejected if you try to do so.

Note: reloadAsync() can be called after promise resolution to reload the app using the most recently downloaded version. Otherwise, the update will be applied on the next app cold start.

Returns


A promise that fulfills with an UpdateFetchResult object.

The promise rejects in Expo Go or if the app is in development mode, or if there is an unexpected error or timeout communicating with the server. It also rejects when expo-updates is not enabled.

Updates.getExtraParamsAsync()

Retrieves the current extra params.

This method cannot be used in Expo Go or development mode. It also rejects when expo-updates is not enabled.

Returns


Updates.readLogEntriesAsync(maxAge)

NameTypeDescription
maxAge
(optional)
number

Sets the max age of retrieved log entries in milliseconds. Default to 3600000 ms (1 hour).

Default: 3600000

Retrieves the most recent expo-updates log entries.

Returns


A promise that fulfills with an array of UpdatesLogEntry objects;

The promise rejects if there is an unexpected error in retrieving the logs.

Updates.reloadAsync()

Instructs the app to reload using the most recently downloaded version. This is useful for triggering a newly downloaded update to launch without the user needing to manually restart the app.

It is not recommended to place any meaningful logic after a call to await Updates.reloadAsync(). This is because the promise is resolved after verifying that the app can be reloaded, and immediately before posting an asynchronous task to the main thread to actually reload the app. It is unsafe to make any assumptions about whether any more JS code will be executed after the Updates.reloadAsync method call resolves, since that depends on the OS and the state of the native module and main threads.

This method cannot be used in Expo Go or development mode, and the returned promise will be rejected if you try to do so. It also rejects when expo-updates is not enabled.

Returns


A promise that fulfills right before the reload instruction is sent to the JS runtime, or rejects if it cannot find a reference to the JS runtime. If the promise is rejected in production mode, it most likely means you have installed the module incorrectly. Double check you've followed the installation instructions. In particular, on iOS ensure that you set the bridge property on EXUpdatesAppController with a pointer to the RCTBridge you want to reload, and on Android ensure you either call UpdatesController.initialize with the instance of ReactApplication you want to reload, or call UpdatesController.setReactNativeHost with the proper instance of ReactNativeHost.

Updates.setExtraParamAsync(key, value)

NameTypeDescription
keystring-
valueundefined | null | string-

Sets an extra param if value is non-null, otherwise unsets the param. Extra params are sent as an Expo Structured Field Value Dictionary in the Expo-Extra-Params header of update requests. A compliant update server may use these params when selecting an update to serve.

This method cannot be used in Expo Go or development mode. It also rejects when expo-updates is not enabled.

Returns


Event Subscriptions

Deprecated. This API is deprecated and will be removed in a future release corresponding with SDK 51. Use useUpdates() instead.

Updates.addListener(listener)

NameTypeDescription
listener(event: UpdateEvent) => void

A function that will be invoked with an UpdateEvent instance and should not return any value.


Adds a callback to be invoked when updates-related events occur (such as upon the initial app load) due to auto-update settings chosen at build-time. See also the useUpdateEvents() React hook.

Returns

  • EventSubscription

An EventSubscription object on which you can call remove() to unsubscribe the listener.

Interfaces

ExpoUpdatesModule

Extends: Pick<ProxyNativeModule, 'addListener' | 'removeListeners'>

ExpoUpdatesModule Properties

NameTypeDescription
channelstring

Can be empty string

checkAutomaticallystring-
checkForUpdateAsync() => Promise<UpdateCheckResultRollBack | UpdateCheckResultNotAvailable | Omit<UpdateCheckResultAvailable, "manifest"> & ({ manifestString: string; } | { manifest: Manifest; })>-
clearLogEntriesAsync() => Promise<void>-
commitTime
(optional)
string-
fetchUpdateAsync() => Promise<UpdateFetchResultFailure | UpdateFetchResultRollBackToEmbedded | Omit<UpdateFetchResultSuccess, "manifest"> & ({ manifestString: string; } | { manifest: Manifest; })>-
getExtraParamsAsync() => Promise<Record<string, string>>-
getNativeStateMachineContextAsync() => Promise<UpdatesNativeStateMachineContext & { downloadedManifestString: string, lastCheckForUpdateTimeString: string, latestManifestString: string, rollbackString: string }>-
isEmbeddedLaunchboolean-
isEmergencyLaunch
(optional)
boolean-
isEnabledboolean-
isUsingEmbeddedAssets
(optional)
boolean-
localAssets
(optional)
Record<string, string>-
manifest
(optional)
Manifest-
manifestString
(optional)
string-
readLogEntriesAsync(maxAge: number) => Promise<UpdatesLogEntry[]>-
reload() => Promise<void>-
runtimeVersionstring

Can be empty string

setExtraParamAsync(key: string, value: null | string) => Promise<void>-
shouldDeferToNativeForAPIMethodAvailabilityInDevelopmentboolean-
updateId
(optional)
string-

Types

CurrentlyRunningInfo

Structure encapsulating information on the currently running app (either the embedded bundle or a downloaded update).

NameTypeDescription
channel
(optional)
string

The channel name of the current build, if configured for use with EAS Update; undefined otherwise.

createdAt
(optional)
Date

If expo-updates is enabled, this is a Date object representing the creation time of the update that's currently running (whether it was embedded or downloaded at runtime).

In development mode, or any other environment in which expo-updates is disabled, this value is undefined.

isEmbeddedLaunchboolean

This will be true if the currently running update is the one embedded in the build, and not one downloaded from the updates server.

isEmergencyLaunchboolean

expo-updates does its very best to always launch monotonically newer versions of your app so you don't need to worry about backwards compatibility when you put out an update. In very rare cases, it's possible that expo-updates may need to fall back to the update that's embedded in the app binary, even after newer updates have been downloaded and run (an "emergency launch"). This boolean will be true if the app is launching under this fallback mechanism and false otherwise. If you are concerned about backwards compatibility of future updates to your app, you can use this constant to provide special behavior for this rare case.

manifest
(optional)
Partial<Manifest>

If expo-updates is enabled, this is the manifest object for the update that's currently running.

In development mode, or any other environment in which expo-updates is disabled, this object is empty.

runtimeVersion
(optional)
string

The runtime version of the current build.

updateId
(optional)
string

The UUID that uniquely identifies the currently running update if expo-updates is enabled. The UUID is represented in its canonical string form and will always use lowercase letters. In development mode, or any other environment in which expo-updates is disabled, this value is undefined.

Example

Manifest

Literal Type: multiple types

Acceptable values are: ExpoUpdatesManifestEmbeddedManifest

UpdateCheckResult

Literal Type: multiple types

The result of checking for a new update.

Acceptable values are: UpdateCheckResultRollBackUpdateCheckResultAvailableUpdateCheckResultNotAvailable

UpdateCheckResultAvailable

The update check result when a new update is found on the server.

NameTypeDescription
isAvailabletrue

Whether an update is available. This property is false for a roll back update.

isRollBackToEmbeddedfalse

Whether a roll back to embedded update is available.

manifestManifest

The manifest of the update when available.

reasonundefined

If no new update is found, this contains one of several enum values indicating the reason.

UpdateCheckResultNotAvailable

The update check result if no new update was found.

NameTypeDescription
isAvailablefalse

Whether an update is available. This property is false for a roll back update.

isRollBackToEmbeddedfalse

Whether a roll back to embedded update is available.

manifestundefined

The manifest of the update when available.

reasonUpdateCheckResultNotAvailableReason

If no new update is found, this contains one of several enum values indicating the reason.

UpdateCheckResultRollBack

The update check result when a rollback directive is received.

NameTypeDescription
isAvailablefalse

Whether an update is available. This property is false for a roll back update.

isRollBackToEmbeddedtrue

Whether a roll back to embedded update is available.

manifestundefined

The manifest of the update when available.

reasonundefined

If no new update is found, this contains one of several enum values indicating the reason.

UpdateEvent

An object that is passed into each event listener when an auto-update check occurs.

NameTypeDescription
manifest
(optional)
Manifest

If type is Updates.UpdateEventType.UPDATE_AVAILABLE, the manifest of the newly downloaded update, and undefined otherwise.

message
(optional)
string

If type is Updates.UpdateEventType.ERROR, the error message, and undefined otherwise.

typeUpdateEventType

Type of the event.

UpdateFetchResult

Literal Type: multiple types

The result of fetching a new update.

Acceptable values are: UpdateFetchResultSuccessUpdateFetchResultFailureUpdateFetchResultRollBackToEmbedded

UpdateFetchResultFailure

The failed result of fetching a new update.

NameTypeDescription
isNewfalse

Whether the fetched update is new (that is, a different version than what's currently running). Always false when isRollBackToEmbedded is true.

isRollBackToEmbeddedfalse

Whether the fetched update is a roll back to the embedded update.

manifestundefined

The manifest of the fetched update.

UpdateFetchResultRollBackToEmbedded

The roll back to embedded result of fetching a new update.

NameTypeDescription
isNewfalse

Whether the fetched update is new (that is, a different version than what's currently running). Always false when isRollBackToEmbedded is true.

isRollBackToEmbeddedtrue

Whether the fetched update is a roll back to the embedded update.

manifestundefined

The manifest of the fetched update.

UpdateFetchResultSuccess

The successful result of fetching a new update.

NameTypeDescription
isNewtrue

Whether the fetched update is new (that is, a different version than what's currently running). Always true when isRollBackToEmbedded is false.

isRollBackToEmbeddedfalse

Whether the fetched update is a roll back to the embedded update.

manifestManifest

The manifest of the fetched update.

UpdateInfo

Literal Type: multiple types

Combined structure representing any type of update.

Acceptable values are: UpdateInfoNewUpdateInfoRollback

UpdatesLogEntry

An object representing a single log entry from expo-updates logging on the client.

NameTypeDescription
assetId
(optional)
string

If present, the unique ID or hash of an asset associated with this log entry.

codeUpdatesLogEntryCode

One of the defined code values for expo-updates log entries.

levelUpdatesLogEntryLevel

One of the defined log level or severity values.

messagestring

The log entry message.

stacktrace
(optional)
string[]

If present, an Android or iOS native stack trace associated with this log entry.

timestampnumber

The time the log was written, in milliseconds since Jan 1 1970 UTC.

updateId
(optional)
string

If present, the unique ID of an update associated with this log entry.

UseUpdatesReturnType

The structures and methods returned by useUpdates().

NameTypeDescription
availableUpdate
(optional)
UpdateInfo

If a new available update has been found, either by using checkForUpdate(), or by the UpdateEvent listener in useUpdates(), this will contain the information for that update.

checkError
(optional)
Error

If an error is returned from either the startup check for updates, or a call to checkForUpdateAsync(), the error description will appear here.

currentlyRunningCurrentlyRunningInfo

Information on the currently running app.

downloadError
(optional)
Error

If an error is returned from either a startup update download, or a call to fetchUpdateAsync(), the error description will appear here.

downloadedUpdate
(optional)
UpdateInfo

If an available update has been downloaded, this will contain the information for that update.

initializationError
(optional)
Error

If an error occurs during initialization of useUpdates(), the error description will appear here.

isCheckingboolean

True if the app is currently checking for a new available update from the server.

isDownloadingboolean

True if the app is currently downloading an update from the server.

isUpdateAvailableboolean

True if a new available update has been found, false otherwise.

isUpdatePendingboolean

True if a new available update is available and has been downloaded.

lastCheckForUpdateTimeSinceRestart
(optional)
Date

A Date object representing the last time this client checked for an available update, or undefined if no check has yet occurred since the app started. Does not persist across app reloads or restarts.

Enums

UpdateCheckResultNotAvailableReason

UpdateCheckResultNotAvailableReason Values

NO_UPDATE_AVAILABLE_ON_SERVER

UpdateCheckResultNotAvailableReason.NO_UPDATE_AVAILABLE_ON_SERVER = "noUpdateAvailableOnServer"

No update manifest or rollback directive received from the update server.

ROLLBACK_NO_EMBEDDED

UpdateCheckResultNotAvailableReason.ROLLBACK_NO_EMBEDDED = "rollbackNoEmbeddedConfiguration"

A rollback directive was received from the update server, but this app has no embedded update.

ROLLBACK_REJECTED_BY_SELECTION_POLICY

UpdateCheckResultNotAvailableReason.ROLLBACK_REJECTED_BY_SELECTION_POLICY = "rollbackRejectedBySelectionPolicy"

A rollback directive was received from the update server, but the directive does not pass the configured selection policy.

UPDATE_PREVIOUSLY_FAILED

UpdateCheckResultNotAvailableReason.UPDATE_PREVIOUSLY_FAILED = "updatePreviouslyFailed"

An update manifest was received from the update server, but the update has been previously launched on this device and never successfully launched.

UPDATE_REJECTED_BY_SELECTION_POLICY

UpdateCheckResultNotAvailableReason.UPDATE_REJECTED_BY_SELECTION_POLICY = "updateRejectedBySelectionPolicy"

An update manifest was received from the update server, but the update is not launchable, or does not pass the configured selection policy.

Deprecated. These APIs are deprecated and will be removed in a future release corresponding with SDK 51. Use useUpdates() instead.

UpdateEventType

The types of update-related events, used with addListener() and useUpdateEvents().

UpdateEventType Values

ERROR

UpdateEventType.ERROR = "error"

An error occurred trying to fetch the latest update.

NO_UPDATE_AVAILABLE

UpdateEventType.NO_UPDATE_AVAILABLE = "noUpdateAvailable"

No updates are available, and the most up-to-date update is already running.

UPDATE_AVAILABLE

UpdateEventType.UPDATE_AVAILABLE = "updateAvailable"

A new update has finished downloading to local storage. If you would like to start using this update at any point before the user closes and restarts the app on their own, you can call Updates.reloadAsync() to launch this new update.

UpdateInfoType

The different possible types of updates. Currently, the only supported type is UpdateInfoType.NEW, indicating a new update that can be downloaded and launched on the device. In the future, other types of updates may be added to this list.

UpdateInfoType Values

NEW

UpdateInfoType.NEW = "new"

This is the type for new updates found on or downloaded from the update server, that are launchable on the device.

ROLLBACK

UpdateInfoType.ROLLBACK = "rollback"

This type is used when an update is a directive to roll back to the embedded bundle.

UpdatesCheckAutomaticallyValue

The possible settings that determine if expo-updates will check for updates on app startup. By default, Expo will check for updates every time the app is loaded. Set this to ON_ERROR_RECOVERY to disable automatic checking unless recovering from an error. Set this to NEVER to completely disable automatic checking.

UpdatesCheckAutomaticallyValue Values

NEVER

UpdatesCheckAutomaticallyValue.NEVER = "NEVER"

Automatic update checks are off, and update checks must be done through the JS API.

ON_ERROR_RECOVERY

UpdatesCheckAutomaticallyValue.ON_ERROR_RECOVERY = "ON_ERROR_RECOVERY"

Only checks for updates when the app starts up after an error recovery.

ON_LOAD

UpdatesCheckAutomaticallyValue.ON_LOAD = "ON_LOAD"

Checks for updates whenever the app is loaded. This is the default setting.

WIFI_ONLY

UpdatesCheckAutomaticallyValue.WIFI_ONLY = "WIFI_ONLY"

Only checks for updates when the app starts and has a Wi-Fi connection.

UpdatesLogEntryCode

The possible code values for expo-updates log entries

UpdatesLogEntryCode Values

ASSETS_FAILED_TO_LOAD

UpdatesLogEntryCode.ASSETS_FAILED_TO_LOAD = "AssetsFailedToLoad"

INITIALIZATION_ERROR

UpdatesLogEntryCode.INITIALIZATION_ERROR = "InitializationError"

JS_RUNTIME_ERROR

UpdatesLogEntryCode.JS_RUNTIME_ERROR = "JSRuntimeError"

NONE

UpdatesLogEntryCode.NONE = "None"

NO_UPDATES_AVAILABLE

UpdatesLogEntryCode.NO_UPDATES_AVAILABLE = "NoUpdatesAvailable"

UNKNOWN

UpdatesLogEntryCode.UNKNOWN = "Unknown"

UPDATE_ASSETS_NOT_AVAILABLE

UpdatesLogEntryCode.UPDATE_ASSETS_NOT_AVAILABLE = "UpdateAssetsNotAvailable"

UPDATE_CODE_SIGNING_ERROR

UpdatesLogEntryCode.UPDATE_CODE_SIGNING_ERROR = "UpdateCodeSigningError"

UPDATE_FAILED_TO_LOAD

UpdatesLogEntryCode.UPDATE_FAILED_TO_LOAD = "UpdateFailedToLoad"

UPDATE_HAS_INVALID_SIGNATURE

UpdatesLogEntryCode.UPDATE_HAS_INVALID_SIGNATURE = "UpdateHasInvalidSignature"

UPDATE_SERVER_UNREACHABLE

UpdatesLogEntryCode.UPDATE_SERVER_UNREACHABLE = "UpdateServerUnreachable"

UpdatesLogEntryLevel

The possible log levels for expo-updates log entries

UpdatesLogEntryLevel Values

DEBUG

UpdatesLogEntryLevel.DEBUG = "debug"

ERROR

UpdatesLogEntryLevel.ERROR = "error"

FATAL

UpdatesLogEntryLevel.FATAL = "fatal"

INFO

UpdatesLogEntryLevel.INFO = "info"

TRACE

UpdatesLogEntryLevel.TRACE = "trace"

WARN

UpdatesLogEntryLevel.WARN = "warn"

Error codes

CodeDescription
ERR_UPDATES_DISABLEDA method call was attempted when the Updates module was disabled, or the application was running in development mode
ERR_UPDATES_RELOADAn error occurred when trying to reload the application and it could not be reloaded. For bare workflow apps, double check the setup steps for this module to ensure it has been installed correctly and the proper native initialization methods are called.
ERR_UPDATES_CHECKAn unexpected error occurred when trying to check for new updates. Check the error message for more information.
ERR_UPDATES_FETCHAn unexpected error occurred when trying to fetch a new update. Check the error message for more information.
ERR_UPDATES_READ_LOGSAn unexpected error occurred when trying to read log entries. Check the error message for more information.