10.8 阶段 7:打包、签名、分发与自动更新
本页目录
一、阶段定位
阶段 6 把应用做稳了:测试、崩溃上报、性能基线都有了。但应用还在你开发机的 bin/Debug 里,用户拿不到。本阶段把开发产物变成可安装、可升级、可回滚的交付物:Windows 出 MSIX/MSI、macOS 出 DMG 并公证、Linux 出 AppImage;安装包要代码签名,否则被系统拦截;还要接自动更新,让用户不用每次手动下载。
与前后阶段的衔接:往上承接阶段 6 的崩溃收集——线上版本号、更新状态都要带在上报上下文里。这是最后一个"交付"阶段,之后阶段 8 是进阶方向。不掌握签名与公证,你的 macOS 应用在用户机器上会被 Gatekeeper 直接拦成"无法打开,因为来自身份不明的开发者";不掌握自动更新的回滚,发版出问题就只能全量撤回。
原有的三条卡点展开成可判断的现象依据:
- 只在开发机打包,干净系统上缺运行库:现象是你在自己电脑上装包没问题,发给同事或虚拟机就报"缺少 .NET Runtime"或"VCRUNTIME140.dll 缺失"。判断依据:你没把运行库打包进安装包,或没写清楚安装前提。
- 签名证书过期或时间戳缺失,安装时被系统拦截:现象是 SmartScreen 弹"Windows 已保护你的电脑",或 macOS Gatekeeper 提示"无法验证开发者"。判断依据:你的签名没有时间戳,证书一过期历史签名就失效;或证书本身过期了没续。
- 更新源没有签名校验,可被中间人替换更新包:现象是你从 HTTP 地址下载更新包,HTTPS 证书校验也没开,更新包是明文 ZIP。判断依据:代码里搜不到验签逻辑,更新源是 HTTP。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| Windows 出一份可安装包(MSI 或 MSIX),经过代码签名 | 在干净虚拟机上安装成功,无 SmartScreen 警告 |
| macOS 出一份 DMG,经过 Developer ID 签名与公证 | 双击打开 Gatekeeper 不拦 |
| Linux 出一份 AppImage,可直接运行 | chmod +x 后双击运行 |
| 自动更新可检查新版本、下载、安装 | 改版本号后应用内提示更新 |
| 更新包签名可校验,失败则中止 | 篡改更新包后应用拒绝安装 |
| 更新失败可回滚到上一版本 | 模拟安装失败,应用回到旧版本 |
建议学时:
- 全职(每天 4–6 小时):2 周,约 50 小时。
- 在职(每天 2 小时、周末补 4 小时):5–6 周,约 55 小时。
学时分配建议:Windows 打包与签名 20%、macOS 签名与公证 20%、Linux 打包 10%、自动更新机制 25%、更新校验与回滚 15%、灰度与企业分发 10%。
三、先修自检
| 先修项 | 合格标准 | 不合格时回到 |
|---|---|---|
| 配置与日志 | 能读写配置文件 | 10.3 阶段 2 |
| 崩溃上报 | 带版本号与上下文 | 10.7 阶段 6 |
| 跨端方案 | Electron/Tauri 打包配置 | 10.6 阶段 5 |
| 安全边界 | 理解权限最小化 | 11.4 安全与合规 |
经验判断:有 Web 经验的人容易把"部署"理解成"传服务器",桌面端要复杂得多——签名、公证、自动更新、回滚,每一步都有平台规则。
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| Windows 安装包 | MSI、MSIX、便携版差异 | 会用 | 08 云原生与 DevOps |
| 代码签名 | 证书类型、时间戳、Signtool | 能讲清原理 | 11.4 安全与合规 |
| macOS 签名公证 | Developer ID、notarization、Gatekeeper、stapler | 会用 | 11.4 安全与合规 |
| Linux 打包 | AppImage、deb/rpm、Flatpak/Snap | 了解 | 08 云原生与 DevOps |
| 自动更新 | electron-updater、Tauri updater、WinSparkle/Sparkle | 会用 | 08 云原生与 DevOps |
| 增量更新 | 差分包、整包更新选择 | 了解 | 08 云原生与 DevOps |
| 更新校验 | 签名校验、HTTPS、回滚 | 能讲清原理 | 11.4 安全与合规 |
| 灰度与企业分发 | 渠道分流、MDM、内网更新源 | 了解 | 11.3 技术选型与权衡 |
进度管理建议:本阶段以 Electron electron-builder + electron-updater 为例,原生栈用 Squirrel/WinSparkle/Sparkle。学完每个模块在笔记里把掌握程度往下调一档;全部到位再看 阶段 8 进阶方向。
五、分模块精讲
5.1 Windows 安装包:MSI、MSIX 与便携版
为什么需要它:Windows 上有三种主要分发形态:传统 MSI(安装包,需安装权限)、MSIX(现代打包应用,沙盒隔离)、便携版(解压即用)。选错格式,企业用户装不上或升级行为不符合预期。
核心机制:
- MSI:传统 Windows Installer 包,安装到
Program Files,需要管理员权限;升级时走卸载旧版再装新版。 - MSIX:Windows 10 引入的现代打包格式,应用在沙盒里运行,自动更新;不依赖管理员权限;通过
MakeAppx.exe或 Visual Studio 打包。 - 便携版:解压即运行,不写注册表,适合 U 盘携带;但无法自动更新、无法写安装目录。
- Electron:
electron-builder出 NSIS(基于 MSI 封装的安装包)或 portable;nsis是最常用的 Windows 目标。
最小可运行示例(electron-builder NSIS 配置):
{
"build": {
"appId": "com.example.notes",
"productName": "我的笔记",
"win": {
"target": ["nsis"],
"icon": "build/icon.ico"
},
"nsis": {
"oneClick": false,
"allowToChangeInstallationDirectory": true,
"createDesktopShortcut": true
}
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 干净系统装包报缺少 .NET Runtime | 没把运行库打包 | 用 self-contained 发布,或写明安装前提 |
| 安装后写数据库报权限错误 | 装在 Program Files 只读 |
数据写 %APPDATA% |
| 升级后旧用户数据丢了 | 便携版覆盖安装 | 数据写用户目录,不写安装目录 |
面试考法:常问"MSIX 与 MSI 的区别"。要答到"MSIX 沙盒隔离、自动更新、不需管理员;MSI 传统安装、需管理员、写注册表"。
5.2 代码签名与时间戳
为什么需要它:未签名的 Windows 安装包会触发 SmartScreen 警告"Windows 已保护你的电脑";未签名的 macOS 应用会被 Gatekeeper 拦截。代码签名证明应用来自你且未被篡改。
核心机制:
- 证书类型:
- EV 代码签名证书:带硬件 token,SmartScreen 立即获得信誉(不需积累下载量)。
- OV 代码签名证书:便宜,但需要下载量积累才不弹 SmartScreen。
- 证书买在可信 CA(DigiCert、Sectigo),存在硬件 token 或云签名服务里。
- 签名命令(Windows Signtool):
signtool sign /f cert.pfx /p password /t http://timestamp.digicert.com /fd SHA256 app.exe - 时间戳:
/t参数指定时间戳服务器;签名时盖时间戳后,即使证书过期,历史签名仍然有效(因为签名时刻证书有效)。 - 不签名的后果:SmartScreen 警告;macOS Gatekeeper 拦截;企业 MDM 拒绝安装。
最小可运行示例(签名命令):
# 用 signtool 给 exe 签名并加盖时间戳
signtool sign /f "mycert.pfx" /p "证书密码" `
/t "http://timestamp.digicert.com" /fd SHA256 `
"MyApp.exe"
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 安装时弹 SmartScreen | 未签名或 OV 证书无信誉 | 用 EV 证书,或积累下载量 |
| 证书过期后历史签名失效 | 签名时没加时间戳 | 重新签名加 /t 时间戳 |
signtool 找不到证书 |
证书没装到用户证书库 | 用 /f cert.pfx 指定文件 |
| 证书密码泄露 | 硬编码在脚本里 | 用云签名服务或环境变量 |
面试考法:常问"时间戳为什么重要"。要答到"签名时加盖时间戳,证明签名时刻证书有效;之后证书过期,历史签名仍可验证;不加时间戳,证书一过期所有历史签名失效"。
5.3 macOS 签名、公证与 Gatekeeper
为什么需要它:macOS 的 Gatekeeper 只允许运行经过 Apple 公证的应用。未公证的应用双击会被拦成"无法打开,因为无法验证开发者"。
核心机制:
- 流程:
- 用 Developer ID Application 证书签名(
codesign)。 - 把 DMG/ZIP 上传 Apple 公证服务(
xcrun notarytool submit)。 - Apple 扫描通过后,把票据"装订"到应用里(
xcrun stapler staple)。 - Gatekeeper 检查签名 + 公证票据,放行。
- 用 Developer ID Application 证书签名(
- 公证被拒常见原因:
- 二进制未签名或签名不正确。
- 用到了已弃用的 API(如
com.apple.security.get-task-allow调试权限)。 - 包含未公证的依赖库。
- stapler:装订票据后,即使离线 Gatekeeper 也能验证。
最小可运行示例(签名 + 公证命令):
# 1. 签名应用
codesign --force --deep --options runtime \
--sign "Developer ID Application: Your Company (TEAMID)" \
"MyApp.app"
# 2. 打包 DMG
hdiutil create -volname "MyApp" -srcfolder "MyApp.app" -ov -format UDZO "MyApp.dmg"
# 3. 公证
xcrun notarytool submit "MyApp.dmg" \
--apple-id "you@example.com" --password "app-specific-password" \
--team-id "TEAMID" --wait
# 4. 装订票据
xcrun stapler staple "MyApp.dmg"
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
cannot be opened because the developer cannot be verified |
未签名或未公证 | 走完整签名+公证流程 |
公证被拒 invalid signature |
二进制未签名 | codesign --deep 签所有依赖 |
| 离线 Gatekeeper 拦截 | 没 stapler | xcrun stapler staple 装订票据 |
面试考法:常问"macOS 公证被拒的常见原因"。要答到"二进制未签名、签名不正确、用了调试权限、包含未公证依赖;用 notarytool log 看拒绝原因"。
5.4 Linux 打包格式
为什么需要它:Linux 发行版碎片化,没有统一包格式。AppImage 是最通用的"单文件运行"方案;deb/rpm 进系统包管理;Flatpak/Snap 沙盒化。
核心机制:
- AppImage:单文件,把应用与依赖打包;
chmod +x AppImage后双击运行;不需要 root。 - deb/rpm:进 Debian/RHEL 系包管理,依赖打包到系统库;不同发行版库版本不同。
- Flatpak/Snap:沙盒化打包,自带运行时;解决发行版依赖差异,但牺牲性能与权限。
- 选型:对外分发用 AppImage(最通用);进发行版仓库用 deb/rpm;企业桌面用 Flatpak。
最小可运行示例(AppImage 打包示意):
# electron-builder 出 AppImage
# 配置:
# "linux": { "target": ["AppImage"], "icon": "build/icon.png" }
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| AppImage 在某发行版缺库 | 没把依赖打包 | 用 AppImage 自带运行时或 Static 构建 |
| deb 装了但启动报错 | 依赖版本不匹配 | 写明依赖,或用 Flatpak |
| 字体显示异常 | 没捆绑字体 | 应用内捆绑字体 |
面试考法:常问"AppImage 与 Flatpak 的区别"。要答到"AppImage 单文件运行,不沙盒;Flatpak 沙盒化,自带运行时,权限更细但性能略损"。
5.5 自动更新机制:electron-updater / Tauri updater / Sparkle
为什么需要它:桌面应用不能让用户每次手动下载。自动更新要做到:启动时检查新版本、下载、校验、安装、重启。
核心机制:
- Electron:
electron-updater从更新源(GitHub Releases、自建服务器)下载latest.yml+app.exe.blockmap;NSIS 目标增量更新。 - Tauri:
tauri-plugin-updater,从updater.json检查版本,下载差分包;签名校验。 - 原生 Windows:Squirrel.Windows 或 WinSparkle;macOS:Sparkle(从 AppCast RSS 检查)。
- 更新流程:
- 应用启动时(或定时)请求
latest.json,比对版本号。 - 有新版本 → 下载到临时目录。
- 校验签名 → 安装 → 重启应用。
- 应用启动时(或定时)请求
- 增量更新:electron-updater 的
blockmap只下载变化的块;Tauri 差分包。
最小可运行示例(electron-updater 配置与代码):
// electron-builder 配置发布
{
"build": {
"publish": {
"provider": "generic",
"url": "https://updates.example.com/notes/"
}
}
}
// main.js
const { autoUpdater } = require('electron-updater');
autoUpdater.on('update-available', (info) => {
// 提示用户:有新版本,开始下载
});
autoUpdater.on('update-downloaded', (info) => {
// 下载完成,提示重启
autoUpdater.quitAndInstall();
});
// 启动时检查
autoUpdater.checkForUpdatesAndNotify();
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 检查更新 404 | publish.url 错或文件没上传 |
检查 latest.yml 是否在 URL 下 |
| 下载完安装失败 | 更新包未签名 | 配 signing 证书 |
| 增量更新失败回退 | blockmap 不匹配 | 重新生成完整包 |
面试考法:常问"自动更新的完整流程"。要答到"检查版本→下载→校验签名→安装→重启;失败回滚;增量用 blockmap/差分包"。
5.6 更新校验、回滚与灰度
为什么需要它:更新源可能被劫持、更新包可能损坏;装坏版本后要能回滚。灰度发布避免一出问题全量回退。
核心机制:
- 签名校验:更新包必须用开发者私钥签名;应用内置公钥验签,验不过拒绝安装。
- HTTPS:更新源必须 HTTPS,防中间人。
- 回滚:安装新版本前把旧版本备份到
backup/;新版本启动失败(崩溃 N 次)自动切回旧版本。 - 灰度:更新源按渠道(
stable/beta)分流;先放 1% 用户,观察崩溃率,再全量。
最小可运行示例(更新源配置 + 公钥校验):
// Tauri updater 配置
{
"plugins": {
"updater": {
"endpoints": ["https://updates.example.com/notes/{{target}}/{{current_version}}"],
"pubkey": "公钥内容"
}
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 更新包被中间人替换 | 更新源是 HTTP | 改 HTTPS,配签名校验 |
| 装新版本后崩溃 | 没回滚机制 | 备份旧版本,崩溃 N 次自动回切 |
| 一发布全量用户升级 | 没灰度 | 按渠道分流,先小比例 |
面试考法:常问"为什么更新包必须验签"。要答到"防中间人替换恶意包;HTTPS 防传输劫持,但更新源本身可能被攻破;签名校验保证包来自开发者"。
六、分层练习
6.1 复现型(照着做,目标是跑通 + 能解释)
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| Windows 出 NSIS 包 | electron-builder 出安装包 | 干净虚拟机安装成功 | 2 小时 |
| 代码签名 | 用测试证书签名 exe | Signtool 验证签名通过 | 2 小时 |
| macOS 出 DMG | 签名 + 公证 + stapler | Gatekeeper 不拦 | 4 小时 |
| 自动更新检查 | 接 electron-updater,启动检查 | 改版本号后提示更新 | 3 小时 |
| 更新源配置 | 部署 latest.yml + 安装包 |
应用能下载 | 2 小时 |
6.2 改造型(给出现成代码,改出正确行为)
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 加时间戳 | 给定签名没加 /t,补上 |
证书过期后历史签名仍有效 | 1 小时 |
| 修 SmartScreen | 给定未签名包,改签名 | 干净系统不弹 SmartScreen | 2 小时 |
| 更新改 HTTPS | 给定 HTTP 更新源,改 HTTPS | 更新源走 HTTPS | 1 小时 |
| 加回滚 | 给定装新版本直接覆盖,改备份旧版本 | 新版本崩溃自动切回 | 3 小时 |
| 灰度渠道 | 给定全量更新,改 stable/beta 分流 | beta 渠道先收到 | 2 小时 |
6.3 设计型(自己定方案,目标是能交付、能讲清取舍)
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 完整更新链路 | 检查→下载→校验→安装→回滚 | 篡改包被拒;失败自动回切 | 8 小时 |
| 三端打包脚本 | 一条命令出 Windows/macOS/Linux 包 | 三端产物齐全 | 6 小时 |
| 企业分发文档 | 写安装、升级、回滚、MDM 部署流程 | 文档可执行 | 4 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
| 安装弹 SmartScreen | 未签名或 OV 无信誉 | 看 exe 属性是否有签名 | 用 EV 证书或积累信誉 |
| macOS 提示"无法验证开发者" | 未公证 | 看 codesign -dv 是否签名 |
走签名+公证+stapler |
| 干净系统缺运行库 | 没打包运行库 | 在虚拟机复现 | self-contained 或写明前提 |
| 更新检查 404 | publish.url 错 |
curl latest.yml |
修正 URL 与文件路径 |
| 更新下载完安装失败 | 更新包未签名 | 看 electron-builder signing | 配置签名证书 |
| 更新包被中间人替换 | HTTP 源 + 无验签 | 抓包看更新源 | 改 HTTPS + 签名校验 |
| 装新版本后崩溃 | 没回滚 | 看启动日志 | 备份旧版本,崩溃自动回切 |
| 一发布全量升级 | 没灰度 | 看更新渠道配置 | 按渠道分流,先小比例 |
八、出口条件
全部勾选后进入 阶段 8:进阶方向(可选),或回到 路径首页。
- [ ] Windows 出一份可安装包(MSI/NSIS),经过代码签名
- [ ] macOS 出一份 DMG,经过 Developer ID 签名与公证
- [ ] Linux 出一份 AppImage,可直接运行
- [ ] 自动更新可检查新版本、下载、安装、回滚
- [ ] 更新包签名可校验,失败则中止
- [ ] 更新源走 HTTPS,按渠道灰度分流
- [ ] 排障表里随机抽三个现象,能在 5 分钟内给出排查路径
自测题(先自己想,再看要点):
- MSIX 与 MSI 的区别?
- 要点:MSIX 沙盒、自动更新、不需管理员;MSI 传统、需管理员、写注册表。
- 代码签名为什么要加时间戳?
- 要点:签名时盖时间戳,证明签名时刻证书有效;之后证书过期历史签名仍有效;不加则证书一过期全部失效。
- macOS 公证被拒的常见原因?
- 要点:二进制未签名、签名不正确、用了调试权限、包含未公证依赖;用
notarytool log看原因。
- 要点:二进制未签名、签名不正确、用了调试权限、包含未公证依赖;用
- 自动更新的完整流程?
- 要点:检查版本→下载→校验签名→安装→重启;失败回滚;增量用 blockmap。
- 为什么更新包必须验签?
- 要点:防中间人替换恶意包;HTTPS 防传输劫持,但更新源可能被攻破;签名保证包来自开发者。
- 灰度发布怎么做?
- 要点:按渠道(stable/beta)分流;先小比例;观察崩溃率再全量。
- AppImage 与 Flatpak 的区别?
- 要点:AppImage 单文件不沙盒;Flatpak 沙盒化自带运行时,权限细但性能略损。