Electron-Builder 中自定义系统版本检查的实现方案

背景介绍

在 Electron 应用开发中，electron-builder 和 electron-updater 是常用的打包和自动更新工具。近期 electron-updater 引入了一个新功能：自动检查系统最低版本要求（minimumSystemVersion）。这个功能默认使用 Node.js 的 os.release() 方法来获取当前系统版本并进行验证。

然而，在实际开发场景中，这种默认实现可能无法满足所有开发者的需求。例如，某些应用可能已经基于 macOS 的产品版本号（如 12.0.0 对应 Monterey）实现了自己的版本检查逻辑，直接切换到 os.release() 的版本号格式会导致兼容性问题。

问题分析

electron-updater 的默认实现存在以下局限性：

1. 版本号格式固定：强制使用 os.release() 返回的版本号格式，无法适配不同操作系统特有的版本标识方式
2. 缺乏扩展性：开发者无法自定义版本检查逻辑，只能接受内置实现
3. 升级兼容性问题：对于已经发布的应用，改变版本检查方式会导致已安装用户无法正常更新

解决方案

electron-updater 团队提出了一个灵活的解决方案：引入 isUpdateSupported 方法作为可覆盖的钩子函数。这个方案具有以下特点：

1. 默认行为保持不变：仍然使用 os.release() 进行版本检查
2. 提供扩展点：开发者可以覆盖 isUpdateSupported 方法实现自定义检查逻辑
3. 向后兼容：不影响现有应用的更新流程

实现细节

核心实现包括两个部分：

1. 在 AppUpdater 类中新增 isUpdateSupported 属性和方法：

get isUpdateSupported() {
    return this._isUpdateSupported;
}
set isUpdateSupported(value) {
    if (value) {
        this._isUpdateSupported = value;
    }
}

2. 将原有的版本检查逻辑提取为独立的 checkIfUpdateSupported 方法，作为默认实现：

checkIfUpdateSupported(updateInfo) {
    const minimumSystemVersion = updateInfo?.minimumSystemVersion;
    const currentOSVersion = os.release();
    // 版本检查逻辑...
    return true;
}

开发者可以这样使用自定义检查逻辑：

autoUpdater.isUpdateSupported = (updateInfo) => {
    // 实现自定义版本检查逻辑
    return customVersionCheck(updateInfo.minimumSystemVersion);
}

最佳实践

对于需要自定义系统版本检查的开发者，建议：

1. 评估现有用户基础：了解已安装用户的版本检查方式
2. 渐进式迁移：可以先发布一个过渡版本，收集使用数据
3. 全面测试：确保自定义逻辑在各种系统版本上都能正确工作
4. 日志记录：在自定义检查中添加详细日志，便于问题排查

总结

electron-updater 通过引入 isUpdateSupported 钩子函数，为开发者提供了更大的灵活性来处理系统版本检查。这种设计既保持了默认实现的简单性，又满足了特殊场景下的定制需求，是框架可扩展性的一个良好实践。

对于需要处理复杂版本检查场景的 Electron 应用开发者，这个功能提供了优雅的解决方案，同时确保了应用的平滑升级路径。