feat: add minimumSystemVersion in electron updater (#8108)

.changeset/chatty-zebras-greet.md

@@ -0,0 +1,7 @@
+---
+"builder-util-runtime": patch
+"builder-util": patch
+"electron-updater": patch
+---
+
+feat: add `minimumSystemVersion` in electron updater

packages/builder-util-runtime/src/updateInfo.ts

@@ -73,6 +73,12 @@ export interface UpdateInfo {
    * The [staged rollout](/auto-update#staged-rollouts) percentage, 0-100.
    */
   readonly stagingPercentage?: number
+
+  /**
+   * The minimum version of system required for the app to run. Sample value: macOS `23.1.0`, Windows `10.0.22631`.
+   * Same with os.release() value, this is a kernel version.
+   */
+  readonly minimumSystemVersion?: string
 }
 
 export interface WindowsUpdateInfo extends UpdateInfo {

packages/electron-updater/src/AppUpdater.ts

@@ -12,6 +12,7 @@ import {
   BlockMap,
 } from "builder-util-runtime"
 import { randomBytes } from "crypto"
+import { release } from "os"
 import { EventEmitter } from "events"
 import { mkdir, outputFile, readFile, rename, unlink } from "fs-extra"
 import { OutgoingHttpHeaders } from "http"
@@ -390,6 +391,19 @@ export abstract class AppUpdater extends (EventEmitter as new () => TypedEmitter
       return false
     }
 
+    const minimumSystemVersion = updateInfo?.minimumSystemVersion
+    const currentOSVersion = release()
+    if (minimumSystemVersion) {
+      try {
+        if (isVersionLessThan(currentOSVersion, minimumSystemVersion)) {
+          this._logger.info(`Current OS version ${currentOSVersion} is less than the minimum OS version required ${minimumSystemVersion} for version ${currentOSVersion}`)
+          return false
+        }
+      } catch (e: any) {
+        this._logger.warn(`Failed to compare current OS version(${currentOSVersion}) with minimum OS version(${minimumSystemVersion}): ${(e.message || e).toString()}`)
+      }
+    }
+
     const isStagingMatch = await this.isStagingMatch(updateInfo)
     if (!isStagingMatch) {
       return false