This repo contains the bare minimum code to have an auto-updating Electron app using electron-updater with releases stored on GitHub.
If you can't use GitHub, you can use other providers:
- Complete electron-updater HTTP example
- Complete electron-updater from gitlab.com private repo example
NOTE: If you want to run through this whole process, either fork this repo or start your own from a template. Then replace all instances of iffy with your GitHub username before doing the following steps.
-
For macOS, you will need a code-signing certificate.
Install Xcode (from the App Store), then follow these instructions to make sure you have a "Developer ID Application" certificate. If you'd like to export the certificate (for automated building, for instance) you can. You would then follow these instructions.
This example application is set up to perform code-signing and notarization on Mac OS provided that a
Developer ID Applicationcertificate is installed in the default keychain. The following environment variables are important for the signing process:CSC_IDENTITY_AUTO_DISCOVERY- controls whetherelectron-buildertries to sign the application; default istrue, set tofalseto skip signingAPPLE_ID- the Apple ID to use for notarization (required for signing).APPLE_ID_PASSWORD- the password to use with the specified Apple ID for notarization (required for signing). Apple recommends setting up an app-specific password to safeguard the Apple ID password (see Apple Support) for more information.
To enable code-signing and notarization:
export CSC_IDENTITY_AUTO_DISCOVERY="true" export APPLE_ID="<your Apple ID>" export APPLE_ID_PASSWORD="<your Apple Password>" -
Adjust
package.jsonif needed.By default,
electron-updaterwill try to detect the GitHub settings (such as the repo name and owner) from reading the.git/configor from reading other attributes withinpackage.json. If the auto-detected settings are not what you want, configure thepublishproperty as follows:{ ... "build": { "publish": [{ "provider": "github", "owner": "iffy", "repo": "electron-updater-example" }], ... } } -
Install necessary dependencies with:
yarnor
npm install -
Generate a GitHub access token by going to https://github.com/settings/tokens/new. The access token should have the
reposcope/permission. Once you have the token, assign it to an environment variableOn macOS/linux:
export GH_TOKEN="<YOUR_TOKEN_HERE>"On Windows, run in powershell:
[Environment]::SetEnvironmentVariable("GH_TOKEN","<YOUR_TOKEN_HERE>","User")Make sure to restart your IDE/Terminal to inherit latest env variable.
-
Publish for your platform with:
electron-builder -p alwaysor
npm run publishIf you want to publish for more platforms, edit the
publishscript i 78D8 npackage.json. For instance, to build for Windows and macOS:... "scripts": { "publish": "electron-builder --mac --win -p always" }, ...NOTE: The Mac OS signing/notarization process must be run on Mac OS.
-
Release the release on GitHub by going to https://github.com/YOUR_GIT_HUB_USERNAME/electron-updater-example/releases, editing the release and clicking "Publish release."
-
Download and install the app from https://github.com/YOUR_GIT_HUB_USERNAME/electron-updater-example/releases.
-
Update the version in
package.json, commit and push to GitHub. -
Do steps 5 and 6 again.
-
Open the installed version of the app and see that it updates itself.