The autoUpdater enables an electron app to check the latest version and update itself automatically. ¹

Installation

You can install autoUpdater via NPM or yarn:

npm install --save—dev electron-updater

or

yarn add electron-updater

Example

In main .js file of electron, autoUpdater can be defined as follows:

// main.js
const { autoUpdater } = require("electron-updater");

autoUpdater.setFeedURL({
    provider: "github",
    host: "github.com",
    owner: "{ username }",
    repo: "{ repository }",
    token: "{ token }",
});

Events

• checking-for-update:
  Emit when checking update has started.

• update-available:
  Emit when there is an available update. If autoDownload = true, the update will be downloaded automatically. The event contains the version, releaseDate, releaseNotes, etc.

• update-not-available:
  Emit when there is no available update.

• error:
  Emit when there is an error.

• download-progress:
  Emit when downloading update has started. The event contains the download percentages.

• update-downloaded:
  Emit when the update has been downloaded. The event contains the version, releaseDate, releaseNotes, downloadFile, etc.

Properties

• autoDownload:
  autoDownload defines whether to automatically download an update when it is found. If autoDownload = false, you should manually execute autoUpdater.downloadUpdate() after receiving update-available event.
• autoInstallOnAppQuit:
  autoInstallOnAppQuit defines whether to automatically install a downloaded update on app quit. If autoInstallOnAppQuit = false, you should manually execute autoUpdater.quitAndInstall().

Methods

• setFeedURL(options):
  Configure update provider. If you use GitHub as provider, options consists of provider, host, owner, repo, token, etc.
• checkForUpdatesAndNotify():
  Ask the server whether there is an update.
• downloadUpdate():
  Start downloading update.
• quitAndInstall():
  Restart the app and install the update after it has been downloaded. This method should be called after update-downloaded has been emitted.