Updates

Install

npx expo install expo-updates

import { Updates } from '@ng-native/expo/updates';

The smallest useful example

import { Component, inject } from '@angular/core';
import { Updates } from '@ng-native/expo/updates';

@Component({
  selector: 'app-root',
  template: ``,
})
export class Root {
  private readonly updates = inject(Updates);

  // On foreground, where a restart costs the user nothing.
  protected async refresh(): Promise<void> {
    if (await this.updates.check()) await this.updates.apply();
  }
}

check()

Checks for an update and downloads it if there is one, resolving to whether an update is now waiting. One method rather than two, because there is nothing useful an app can do between checking and downloading: an app that checks without downloading has learnt something it cannot act on. While it runs, state() moves through 'checking' then 'downloading'; a failure at either step lands in error() and moves state() to 'error' rather than throwing.

apply()

Restarts the app into the downloaded update. Only does anything when state() is 'ready' - call it after check() resolves true, or after reading ready(). This restarts the app, which is why nothing here does it automatically: the moment to do it is one the app knows and this does not - not mid-form, not mid-upload, usually on next foreground.

State

• state - 'idle', 'checking', 'downloading', 'ready' or 'error'.
• ready - true exactly when state() is 'ready', the only state in which apply() does anything.
• error - whatever check() caught, or null.
• enabled - whether updates are enabled at all. False in development and in Expo Go, where the bundle comes from Metro rather than a published update. An app should hide an "update available" banner here rather than show one that can never resolve; check() itself is a no-op and resolves false when this is false, so it is safe to call unconditionally.

Without the module installed

enabled is false and check() resolves false without doing anything, the same behaviour as running in Expo Go. apply() does nothing, since state() can never reach 'ready'.

Reference