Electron Forge 实现 macOS 应用自动更新的技术方案

在 Electron 应用开发中，自动更新是一个非常重要的功能。对于使用 Electron Forge 构建的项目，在 macOS 平台上实现自动更新需要特别注意一些技术细节。

macOS 自动更新的基本原理

macOS 平台的自动更新机制与 Windows 平台有所不同。Electron 官方推荐使用内置的 autoUpdater 模块来实现跨平台自动更新功能。在 macOS 上，这个模块底层使用的是 Apple 的 Sparkle 框架。

使用 Electron Forge 配置 macOS 自动更新

Electron Forge 提供了简化的配置方式来设置自动更新功能。对于 macOS 平台，关键是要正确配置发布渠道和更新服务器。

1. 配置发布渠道

在 forge 配置文件中，需要明确指定 macOS 平台的发布渠道。通常使用 ZIP 格式作为发布包：

module.exports = {
  packagerConfig: {
    osxSign: {},
    osxNotarize: {
      tool: 'notarytool',
      appleId: process.env.APPLE_ID,
      appleIdPassword: process.env.APPLE_PASSWORD,
      teamId: process.env.APPLE_TEAM_ID
    }
  },
  makers: [
    {
      name: '@electron-forge/maker-zip',
      platforms: ['darwin']
    }
  ],
  publishers: [
    {
      name: '@electron-forge/publisher-github',
      config: {
        repository: {
          owner: 'your-github-username',
          name: 'your-repo-name'
        },
        prerelease: false
      }
    }
  ]
}

2. 设置自动更新检查

在应用主进程中，需要初始化自动更新功能：

const { autoUpdater } = require('electron-updater')

function checkForUpdates() {
  autoUpdater.checkForUpdatesAndNotify()
}

app.whenReady().then(() => {
  // 确保应用准备好后再检查更新
  checkForUpdates()
  
  // 可以设置定时检查，比如每小时一次
  setInterval(checkForUpdates, 60 * 60 * 1000)
})

更新服务器配置

对于托管在 GitHub Releases 上的应用，Electron Forge 会自动处理大部分配置。但需要注意以下几点：

1. 确保每次发布的 ZIP 文件包含正确的应用签名
2. 版本号必须遵循语义化版本控制规范
3. 发布时应该包含完整的发行说明

代码签名与公证

macOS 的自动更新功能对代码签名有严格要求：

1. 必须使用有效的 Apple 开发者证书签名应用
2. 建议进行公证（Notarization）处理，否则在较新 macOS 版本上可能无法正常运行
3. 签名和公证应该在构建过程中自动完成

测试自动更新功能

在开发过程中，可以通过以下方式测试自动更新：

1. 发布一个较低版本的应用
2. 安装并运行这个版本
3. 发布一个更高版本
4. 观察低版本应用是否能正确检测并下载更新

常见问题解决

1. 更新不生效：检查代码签名是否正确，确保公证过程没有错误
2. 更新检测失败：验证网络连接，检查 GitHub API 访问权限
3. 更新后应用崩溃：确保新旧版本的数据结构兼容

通过以上配置，开发者可以轻松地为基于 Electron Forge 构建的 macOS 应用实现可靠的自动更新功能，为用户提供无缝的升级体验。