罗罗编程学习记录
本页内容 展开查看

07.5.2 打包、签名与自动更新

所属:全栈开发面试题库 / 07 端侧与桌面开发 / 07.5 Electron 与 Tauri

覆盖范围

  • electron-builder 配置与产物(nsis / dmg / AppImage / deb)
  • Windows Code Signing 与 macOS Developer ID 签名
  • electron-updater 的更新流程、通道与增量包
  • 自动更新的验签、回滚与灰度策略
  • 多渠道分发(官网、Microsoft Store、Mac App Store)

高频题速览

编号 题目 难度 频率
07.5.2-001 electron-builder 的主要产物有哪些? 基础 ★★★★
07.5.2-002 Windows 和 macOS 为什么都必须代码签名? 基础 ★★★★★
07.5.2-003 electron-updater 的工作流程是什么? 基础 ★★★★★
07.5.2-004 更新包为什么需要签名?如何防中间人替换? 进阶 ★★★★
07.5.2-005 增量更新(差量包)原理是什么? 进阶 ★★★
07.5.2-006 灰度发布与渠道如何设计? 进阶 ★★★
07.5.2-007 自动更新失败如何回滚? 进阶 ★★★
07.5.2-008 macOS 公证(notarization)是什么?为什么必须做? 进阶 ★★★
07.5.2-009 如何配置多平台同时打包? 基础 ★★★
07.5.2-010 应用内置的版本号与构建号如何管理? 基础 ★★

07.5.2-001 electron-builder 的主要产物有哪些?

频率 ★★★★ | 难度 基础

一句话结论

electron-builder 按目标平台产出:Windows 生成 NSIS 安装包(.exe)和便携版(.exe portable);macOS 生成 .dmg 和 .app;Linux 生成 .deb、.rpm、AppImage(.AppImage)和 tar.gz;同时生成 latest.yml / latest-mac.yml 等更新元数据文件。

概念解释

  • NSIS:Windows 最常用的安装器,支持一键安装、卸载、管理员权限请求。
  • DMG:macOS 的磁盘镜像,用户拖拽 .app 到 Applications 文件夹。
  • AppImage:Linux 通用格式,单文件可执行,不需要安装。
  • 元数据文件:latest.yml(Windows/Linux)、latest-mac.yml(macOS),electron-updater 读取这些文件判断是否有新版本。

代码 / 示例

// package.json 中 electron-builder 配置
{
  "build": {
    "appId": "com.example.desktop",
    "productName": "MyApp",
    "win": { "target": ["nsis", "portable"] },
    "mac": { "target": ["dmg"], "category": "public.app-category.productivity" },
    "linux": { "target": ["AppImage", "deb"], "category": "Utility" },
    "nsis": { "oneClick": false, "allowToChangeInstallationDirectory": true }
  }
}

常见误区

  • 误区:只打一种格式;正解:不同渠道需要不同格式(官网用 NSIS,商店用 MSIX 等)。
  • 误区:产物直接分发不做签名;正解:未签名的应用在 Windows 会弹 SmartScreen,macOS 会被 Gatekeeper 拦截。

追问 / 延伸

  • MSIX 是什么?Windows 新的打包格式,支持 Microsoft Store 和企业分发。
  • 打包产物体积过大怎么优化?在 07.5.5 主题页详细展开。

07.5.2-002 Windows 和 macOS 为什么都必须代码签名?

频率 ★★★★★ | 难度 基础

一句话结论

代码签名证明应用身份(发布者)未被篡改;Windows 上未签名的应用会触发 SmartScreen 警告甚至被杀毒软件拦截,macOS 上未签名的应用会被 Gatekeeper 阻止打开;签名后用户才能信任运行,企业分发和商店上架也强制要求签名。

概念解释

  • Windows Code Signing Certificate:从 CA(如 DigiCert、Sectigo)购买,签名后 exe 右键属性可见发布者信息。EV 代码签名证书可立即获得 SmartScreen 信誉。
  • macOS Developer ID:由 Apple 颁发,签名后应用可以在 App Store 外分发(即「 Outside the Mac App Store」);还需要 notarization(公证)才能在 macOS 10.15+ 无警告运行。
  • 签名包含:证书链、应用二进制哈希、时间戳(保证证书过期后签名仍有效)。

常见误区

  • 误区:自签名证书可以直接用;正解:自签名证书不被系统信任,用户必须手动安装根证书,普通用户做不到。
  • 误区:签一次名以后不用再签;正解:每个版本发版都要签名,因为二进制变了。

追问 / 延伸

  • 证书丢失或泄露怎么办?立即吊销证书,所有已签名版本仍可运行(吊销后新安装会被警告)。
  • Apple Developer ID 类型有哪些?Developer ID Application(签 .app)、Developer ID Installer(签 pkg 安装包)。

07.5.2-003 electron-updater 的工作流程是什么?

频率 ★★★★★ | 难度 基础

一句话结论

应用启动后(或定时),electron-updater 从配置的 update provider 拉取 latest.yml / latest-mac.yml,与当前版本号比较;如果有新版本,下载更新包到缓存目录;下载完成后校验哈希与签名;退出时安装更新,重启进入新版本。

概念解释

  • update provider:可以是 GitHub Releases、S3、自建 HTTP 服务器(generic provider)。
  • 版本比较遵循 SemVer:latest.yml 中的 version 字段大于当前版本即触发更新。
  • 下载是异步的,不阻塞应用运行;下载完成后通知用户「重启以更新」。
  • Windows 上通过 Squirrel 框架执行安装,macOS 上通过内置的更新器框架。

代码 / 示例

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

autoUpdater.setFeedURL({
  provider: 'generic',
  url: 'https://example.com/updates/'
})

autoUpdater.on('update-downloaded', () => {
  dialog.showMessageBox({
    message: '更新已下载,是否立即重启?'
  }).then(() => autoUpdater.quitAndInstall())
})

// 在 app.whenReady() 后调用
autoUpdater.checkForUpdatesAndNotify()

常见误区

  • 误区:自动更新不需要用户确认;正解:更新安装会重启应用丢失未保存数据,必须让用户确认。
  • 误区:latest.yml 随便改;正解:yml 里的 sha512 必须与更新包实际哈希一致,否则校验失败。

追问 / 延伸

  • 如何强制更新?发现旧版本时弹窗阻止使用,直到更新完成。
  • 下载中断怎么办?electron-updater 支持断点续传(取决于 provider)。

07.5.2-004 更新包为什么需要签名?如何防中间人替换?

频率 ★★★★ | 难度 进阶

一句话结论

更新通道本身(HTTP 服务器)可能被攻破或 DNS 劫持,攻击者替换更新包即可植入恶意软件;因此更新包除了在平台侧代码签名外,electron-updater 还会校验 latest.yml 中的 sha512 哈希;更严格的做法是对 latest.yml 本身做签名,客户端内置公钥验签。

概念解释

  • electron-updater 默认行为:下载 .exe / .dmg 后校验 sha512(来自 latest.yml),但 latest.yml 本身如果被篡改,哈希也会被篡改。
  • 完整防护链:客户端内置公钥 → 拉取 latest.yml(包含版本、包地址、包哈希、签名)→ 验签 latest.yml → 下载包 → 校验包哈希 → 平台签名校验(Windows 验 EV 证书,macOS 验 Developer ID)。
  • 平台代码签名是最后一道防线:即使哈希被替换,Windows 加载未签名/错误签名的 exe 会被 SmartScreen 阻止。

常见误区

  • 误区:用 HTTPS 就够了;正解:HTTPS 防传输中篡改,但服务器被攻破时内容全是假的。
  • 误区:只校验哈希;正解:哈希和 yml 可能一起被改,必须对 yml 做独立签名。

追问 / 延伸

  • 公钥内置如何轮换?客户端发新版本时更换公钥,旧版本在迁移期内同时接受新旧公钥。
  • 开源项目怎么处理?在 README 中公布公钥指纹,让用户独立验证。

07.5.2-005 增量更新(差量包)原理是什么?

频率 ★★★ | 难度 进阶

一句话结论

增量更新只下载两个版本之间变更的文件片段(bsdiff 或类似算法),客户端本地合并成新版本;electron-updater 的 differential download 功能会自动在 latest.yml 中列出各旧版本到新版本的差量包,优先下载差量包,失败回退全量包。

概念解释

  • 桌面应用每次发版可能几百 MB,全量下载对弱网用户不友好。
  • bsdiff 算法:通过比对二进制差异生成很小的补丁文件(通常几 MB 到几十 MB)。
  • 客户端合并:新文件 = 旧文件 + 差量补丁,合并后校验哈希。
  • 差量包必须由发布侧针对每一对(旧版本 → 新版本)预先生成,存储成本随版本数平方增长。

常见误区

  • 误区:差量包可以跨多个版本升级;正解:差量包是版本对版本的,比如 1.0→1.1 一个包,1.0→1.2 另一个包。
  • 误区:差量合并失败无兜底;正解:必须保留全量包作为 fallback。

追问 / 延伸

  • electron-updater 自动生成差量包吗?需要在构建配置中开启,发布到 provider 后自动计算。
  • 大资源文件(如模型文件、视频)怎么处理?独立版本化,不走应用差量通道。

07.5.2-006 灰度发布与渠道如何设计?

频率 ★★★ | 难度 进阶

一句话结论

按用户群或比例拆分更新渠道:stable(稳定版)、beta(预发布)、dev(内部);每个渠道有独立的 latest.yml;客户端在配置中指定渠道,只检查对应渠道的更新;灰度按比例放量,监控崩溃率与关键指标,异常时撤回渠道。

概念解释

  • 渠道本质是不同的 URL 路径:/updates/stable/latest.yml、/updates/beta/latest.yml。
  • 客户端在启动时读取配置(用户设置或远程下发),决定检查哪个渠道。
  • 灰度策略:内部员工 100% → 1% 外部用户 → 10% → 50% → 100%;每档观察 24 小时。
  • 监控指标:崩溃率、启动成功率、核心功能错误率、更新成功率。

代码 / 示例

autoUpdater.channel = userConfig.channel || 'stable'
// 对应 URL: https://example.com/updates/stable/latest.yml
//           https://example.com/updates/beta/latest.yml

常见误区

  • 误区:所有用户同时收到新版本;正解:问题版本会全量暴露,损失不可控。
  • 误区:灰度不监控指标;正解:必须有监控才能及时止损。

追问 / 延伸

  • 如何按用户 ID 做灰度?客户端上报用户 ID,服务端根据 ID 哈希决定返回 stable 还是 beta 的 yml。
  • 已安装 beta 的用户如何切回 stable?强制卸载后重装,或提供「退出 beta」入口。

07.5.2-007 自动更新失败如何回滚?

频率 ★★★ | 难度 进阶

一句话结论

更新安装前备份当前版本可执行文件(或使用系统还原点);新版本启动时做健康检查(启动超时、崩溃次数阈值),失败则自动回滚到上一版本;回滚后上报事件,暂停该版本的更新推送。

概念解释

  • 自动更新最大的风险:新版本启动即崩溃,用户被锁死在不可用状态。
  • 回滚机制:Windows 上 Squirrel 有 --rollback 参数;macOS 上可以保留旧 .app 在备份目录,启动失败时切换。
  • 健康检查:应用启动后 N 秒内必须上报「启动成功」事件,否则判定为失败。
  • 崩溃计数:连续崩溃 3 次以上触发回滚。

常见误区

  • 误区:更新成功了就不会再出问题;正解:新版本可能在特定环境(GPU 驱动、系统版本)下崩溃。
  • 误区:回滚没有日志;正解:回滚事件必须上报,否则团队不知道有多少用户受影响。

追问 / 延伸

  • 数据库迁移失败怎么办?数据迁移与应用更新解耦,迁移前备份数据库,失败回滚数据库。
  • 回滚后用户的数据会怎样?应用数据目录不变,旧版本读取可能不兼容,需要数据迁移逻辑。

07.5.2-008 macOS 公证(notarization)是什么?为什么必须做?

频率 ★★★ | 难度 进阶

一句话结论

公证是 Apple 对 Developer ID 签名的应用进行云端扫描,确认不含恶意软件和已知漏洞;macOS 10.15(Catalina)及以上要求所有不在 Mac App Store 分发的应用必须经过公证,否则 Gatekeeper 会阻止打开;公证成功后还要「staple」(票据钉选)让离线时也能验证。

概念解释

  • 流程:用 Developer ID 签名 → 用 notarytool 上传到 Apple → Apple 扫描(几分钟到几小时)→ 拿到票据 → 用 stapler 把票据钉到 .app / .dmg 上。
  • 公证不检查应用功能,只检查恶意代码、权限滥用、已知漏洞签名。
  • 未公证的应用:用户双击时提示「无法打开,因为Apple无法检查其是否包含恶意软件」,用户必须右键「打开」才能绕过(但 macOS 新版本可能完全阻止)。

代码 / 示例

# 公证
xcrun notarytool submit MyApp.dmg \
  --apple-id "dev@example.com" \
  --team-id "TEAMID" \
  --password "xxxx-xxxx-xxxx-xxxx" \
  --wait

# 钉选票据
xcrun stapler staple MyApp.dmg

常见误区

  • 误区:只签名不公证;正解:macOS 10.15+ 未公证的应用用户体验极差。
  • 误区:公证一次永久有效;正解:每个新版本都要重新公证,因为二进制变了。

追问 / 延伸

  • 公证被拒怎么办?看邮件日志,通常是包含旧版 SDK、未hardened runtime、或权限声明不全。
  • Hardened Runtime 是什么?强制的运行时安全配置,限制 dylib 注入、JIT 等,公证前提条件。

07.5.2-009 如何配置多平台同时打包?

频率 ★★★ | 难度 基础

一句话结论

在 electron-builder 配置中指定每个平台的 target,CI 上使用对应平台的构建机器(Windows 构建 Windows 产物,macOS 构建 macOS 产物,Linux 构建 Linux 产物);因为代码签名和平台工具链无法跨平台(Windows 签名需要 Windows,macOS 签名需要 macOS)。

概念解释

  • Windows 上不能直接构建 macOS 签名产物(没有 codesign 工具和 Apple 证书)。
  • CI 方案:GitHub Actions 配置 matrix(windows-latest、macos-latest、ubuntu-latest),每个平台跑自己的构建。
  • 产物上传到 Release 或对象存储,各平台用户下载对应产物。

常见误区

  • 误区:在一台机器上打所有平台包;正解:签名和原生工具链必须在对应平台。
  • 误区:Linux 产物在 macOS 上打包就行;正解:可以交叉构建,但 deb 依赖检查可能不准。

追问 / 延伸

  • Docker 能不能解决?可以,用 Linux 容器构建 Linux 产物,但 Windows 仍需 Windows 机器。
  • 跨平台配置如何共享?用 electron-builder 的 extends 或环境变量注入证书路径。

07.5.2-010 应用内置的版本号与构建号如何管理?

频率 ★★ | 难度 基础

一句话结论

版本号遵循 SemVer(major.minor.patch),存储在 package.json 的 version 字段;electron-builder 自动读取并写入应用元数据;构建号(build number)用于 CI 追踪,可通过 electron-builder 的 buildVersion 配置注入;更新器比较版本号决定是否更新。

概念解释

  • SemVer:主版本(不兼容 API)、次版本(向下兼容功能)、修订号(bug 修复)。
  • Windows 版本格式:major.minor.build.patch(4 段),如 1.0.0.0;macOS 用 CFBundleShortVersionString(展示)和 CFBundleVersion(构建号)。
  • 版本号一旦发布就不能回退:更新器只往大版本更新,不降级。

常见误区

  • 误区:开发版本号随意写;正解:发版前统一 bump,避免多个包版本不一致。
  • 误区:版本号里带预发布标签(如 1.0.0-beta.1);正解:electron-updater 对预发布标签的处理依赖配置,建议用渠道区分而非版本号。

追问 / 延伸

  • 如何自动 bump 版本?CI 中根据 tag 自动设置 version,不手动改 package.json。
  • 版本号在应用内哪里展示?关于页面、设置页、日志中都要包含版本号,便于用户反馈问题。

07.5.2-011 什么是代码签名?

频率 ★★★ | 难度 中级

一句话结论

代码签名:用数字证书给应用签名,证明应用是可信的(没被篡改、来源可靠);Windows 用 Authenticode 证书,macOS 用 Developer ID 证书;不签名的应用会被系统拦截(SmartScreen Gatekeeper),用户体验差;签名后自动更新才能正常工作(防止中间人攻击)。

常见误区

  • 误区:签名就是花钱买证书;正解:签名是信任体系,不是形式。
  • 误区:不签名也能用;正解:不签名用户要手动绕过系统拦截,流失大。

追问 / 延伸

  • 证书从哪里买?Windows:DigiCert/Sectigo;macOS:Apple Developer。
  • 证书丢了怎么办?Windows 可以重新买(但旧签名要保留),macOS 可以重新申请。

07.5.2-012 什么是公证(Notarization)?

频率 ★★ | 难度 中级

一句话结论

公证是 Apple 的要求:macOS 应用必须经过 Apple 公证(提交到 Apple 服务器扫描,确保没有恶意代码);不公证的应用在 macOS 上会被 Gatekeeper 拦截;公证是自动的(用 notarytool 提交),一般 5 分钟出结果;签名 + 公证是 macOS 分发的标配。

常见误区

  • 误区:签名了就不用公证;正解:签名和公证是两回事,都要。
  • 误区:公证很慢;正解:现在一般 5 分钟内完成。

追问 / 延伸

  • 怎么公证?xcrun notarytool submit --apple-id xxx --team-id xxx。
  • 公证被拒了怎么办?看拒绝原因(一般是有恶意代码或用了废弃 API)。

待整理清单

  • [ ] electron-builder 各平台 target 完整对照表
  • [ ] Windows EV 证书与 OV 证书的差异
  • [ ] Squirrel.Windows 与 NSIS 的选型