更新应用程序
有几种方式可以为你的 Electron 应用程序提供自动更新。最简单且官方支持的方式是利用内置的 Squirrel 框架和 Electron 的 autoUpdater 模块。
使用云对象存储（无服务器）
对于简单的无服务器更新流程，Electron 的 autoUpdater 模块可以通过指向一个包含最新发布元数据的静态存储 URL 来检查是否有可用更新。
当有新版本可用时，此元数据需要与发布本身一起发布到云存储中。macOS 和 Windows 的元数据格式不同。
发布发布元数据
使用 Electron Forge，你可以通过 ZIP Maker（macOS）的 macUpdateManifestBaseUrl 和 Squirrel.Windows Maker（Windows）的 remoteReleases 来发布元数据工件，从而设置静态文件存储更新。
有关端到端示例，请参阅 Forge 的 从 S3 自动更新 指南。
手动发布
在 macOS 上，Squirrel.Mac 可以通过读取一个 releases.json 文件来接收更新，该文件具有以下 JSON 格式：
{
"currentRelease": "1.2.3",
"releases": [
{
"version": "1.2.1",
"updateTo": {
"version": "1.2.1",
"pub_date": "2023-09-18T12:29:53+01:00",
"notes": "Theses are some release notes innit",
"name": "1.2.1",
"url": "https://mycompany.example.com/myapp/releases/myrelease"
}
},
{
"version": "1.2.3",
"updateTo": {
"version": "1.2.3",
"pub_date": "2024-09-18T12:29:53+01:00",
"notes": "Theses are some more release notes innit",
"name": "1.2.3",
"url": "https://mycompany.example.com/myapp/releases/myrelease3"
}
}
]
}
在 Windows 上，Squirrel.Windows 可以通过读取构建过程中生成的 RELEASES 文件来接收更新。此文件详细说明了要更新的 .nupkg 增量包。
B0892F3C7AC91D72A6271FF36905FEF8FE993520 electron-fiddle-0.36.3-full.nupkg 103298365
这些文件应与你的发布文件位于同一目录中，并在一个能够识别你应用程序平台和架构的文件夹结构下。
例如
my-app-updates/
├─ darwin/
│ ├─ x64/
│ │ ├─ my-app-1.0.0-darwin-x64.zip
│ │ ├─ my-app-1.1.0-darwin-x64.zip
│ │ ├─ RELEASES.json
│ ├─ arm64/
│ │ ├─ my-app-1.0.0-darwin-arm64.zip
│ │ ├─ my-app-1.1.0-darwin-arm64.zip
│ │ ├─ RELEASES.json
├─ win32/
│ ├─ x64/
│ │ ├─ my-app-1.0.0-win32-x64.exe
│ │ ├─ my-app-1.0.0-win32-x64.nupkg
│ │ ├─ my-app-1.1.0-win32-x64.exe
│ │ ├─ my-app-1.1.0-win32-x64.nupkg
│ │ ├─ RELEASES
读取发布元数据
消耗元数据的最简单方法是安装 update-electron-app，这是一个即插即用的 Node.js 模块，可以设置 autoUpdater 并使用原生对话框提示用户。
对于静态存储更新，请将 updateSource.baseUrl 参数指向包含你的发布元数据文件的目录。
const { updateElectronApp, UpdateSourceType } = require('update-electron-app')
updateElectronApp({
updateSource: {
type: UpdateSourceType.StaticStorage,
baseUrl: `https://my-bucket.s3.amazonaws.com/my-app-updates/${process.platform}/${process.arch}`
}
})
使用 update.electronjs.org
Electron 团队维护着 update.electronjs.org，这是一个免费的开源 Web 服务，Electron 应用程序可以利用它来进行自我更新。该服务专为符合以下标准的 Electron 应用程序设计：
- 应用程序运行在 macOS 或 Windows 上
- 应用程序有一个公共 GitHub 存储库
- 构建已发布到 GitHub Releases
- 构建已 代码签名 （**仅限 macOS**）
使用此服务的最简单方法是安装 update-electron-app，这是一个预配置为与 update.electronjs.org 一起使用的 Node.js 模块。
使用你选择的 Node.js 包管理器安装该模块：
- npm
- Yarn
npm install update-electron-app
yarn add update-electron-app
然后，从应用程序的主进程文件中调用更新器：
require('update-electron-app')()
默认情况下，此模块将在应用程序启动时检查更新，然后每十分钟检查一次。找到更新后，它将在后台自动下载。下载完成后，将显示一个对话框，允许用户重启应用程序。
如果你需要自定义配置，可以 向 update-electron-app 传递选项 或 直接使用更新服务。
使用其他更新服务
如果你正在开发私有 Electron 应用程序，或者不将发布版本发布到 GitHub Releases，则可能需要运行自己的更新服务器。
步骤 1：部署更新服务器
根据你的需求，你可以从以下选项中选择：
- Hazel – 私有或开源应用程序的更新服务器，可以在 Vercel 上免费部署。它从 GitHub Releases 拉取，并利用 GitHub CDN 的强大功能。
- Nuts – 也使用 GitHub Releases，但将应用程序更新缓存到磁盘并在支持私有存储库。
- electron-release-server – 提供一个用于处理发布的仪表板，并且不需要发布源自 GitHub。
- Nucleus – 由 Atlassian 维护的 Electron 应用程序的完整更新服务器。支持多个应用程序和通道；使用静态文件存储来最小化服务器成本。
部署更新服务器后，你可以通过 Electron 的 autoUpdater 模块来集成应用程序代码以接收和应用更新。
步骤 2：在应用程序中接收更新
首先，在你的主进程代码中导入所需的模块。以下代码可能会因服务器软件的不同而有所差异，但当使用 Hazel 时，其工作方式如下所述。
请确保以下代码仅在你打包的应用程序中执行，而不是在开发环境中执行。你可以使用 app.isPackaged API 来检查环境。
const { app, autoUpdater, dialog } = require('electron')
接下来，构建更新服务器 Feed 的 URL，并告知 autoUpdater 关于它的信息。
const server = 'https://your-deployment-url.com'
const url = `${server}/update/${process.platform}/${app.getVersion()}`
autoUpdater.setFeedURL({ url })
最后一步是检查更新。下面的示例每分钟检查一次。
setInterval(() => {
autoUpdater.checkForUpdates()
}, 60000)
一旦你的应用程序被 打包，它将收到你发布的每一个新的 GitHub Release 的更新。
步骤 3：通知用户更新可用
现在你已经配置了应用程序的基本更新机制，你需要确保用户在有可用更新时能够得到通知。这可以通过使用 autoUpdater API 事件 来实现。
autoUpdater.on('update-downloaded', (event, releaseNotes, releaseName) => {
const dialogOpts = {
type: 'info',
buttons: ['Restart', 'Later'],
title: 'Application Update',
message: process.platform === 'win32' ? releaseNotes : releaseName,
detail:
'A new version has been downloaded. Restart the application to apply the updates.'
}
dialog.showMessageBox(dialogOpts).then((returnValue) => {
if (returnValue.response === 0) autoUpdater.quitAndInstall()
})
})
同时，请确保 错误得到处理。以下是一个将错误记录到 stderr 的示例：
autoUpdater.on('error', (message) => {
console.error('There was a problem updating the application')
console.error(message)
})
由于 autoUpdate 发出的请求不在你的直接控制之下，你可能会遇到一些难以处理的情况（例如，更新服务器需要身份验证）。url 字段支持 file:// 协议，这意味着通过一些努力，你可以通过从本地目录加载更新来绕过该过程的服务器通信方面。 这是一个关于如何实现此功能的示例。
更新服务器规范
对于高级部署需求，你也可以推出自己的 Squirrel 兼容更新服务器。例如，你可能希望有基于百分比的发布、通过单独的发布渠道分发你的应用程序，或者将你的更新服务器置于身份验证检查之后。
Squirrel.Windows 和 Squirrel.Mac 客户端需要不同的响应格式，但你可以通过根据 process.platform 的值将请求发送到不同的端点来为两个平台使用单个服务器。
const { app, autoUpdater } = require('electron')
const server = 'https://your-deployment-url.com'
// e.g. for Windows and app version 1.2.3
// https://your-deployment-url.com/update/win32/1.2.3
const url = `${server}/update/${process.platform}/${app.getVersion()}`
autoUpdater.setFeedURL({ url })
Windows
Squirrel.Windows 客户端期望更新服务器在你的端点的 /RELEASES 子路径上返回最新可用构建的 RELEASES 工件。
例如，如果你的 Feed URL 是 https://your-deployment-url.com/update/win32/1.2.3，那么 https://your-deployment-url.com/update/win32/1.2.3/RELEASES 端点应返回你想提供的版本的 RELEASES 工件的内容。
B0892F3C7AC91D72A6271FF36905FEF8FE993520 https://your-static.storage/your-app-1.2.3-full.nupkg 103298365
Squirrel.Windows 会进行比较检查，以确定当前应用程序是否应更新到 RELEASES 中返回的版本，因此即使没有可用的更新，你也应该返回一个响应。
macOS
当有可用更新时，Squirrel.Mac 客户端期望在 Feed URL 的端点处收到 JSON 响应。该对象有一个必需的 url 属性，它映射到应用程序更新的 ZIP 存档。对象中的所有其他属性都是可选的。
{
"url": "https://your-static.storage/your-app-1.2.3-darwin.zip",
"name": "1.2.3",
"notes": "Theses are some release notes innit",
"pub_date": "2024-09-18T12:29:53+01:00"
}
如果没有可用更新，服务器应返回 204 No Content HTTP 响应。