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 的选型