桌面平台的打包与分发
使用 electron-builder 为 macOS、Windows 和 Linux 构建安装程序,并实现代码签名和自动更新。
桌面平台的打包与分发 是 CoddyKit 上的免费 React Academy 课时。 这是第 4 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 React Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 React Academy 课程共包含 4 节课。
electron-builder 配置
electron-builder 是将 Electron 应用打包为可分发安装程序的标准工具。它的配置位于 package.json 的 "build" 键下,用于指定应用元数据(appId、productName)、图标路径以及各平台的目标格式。
各平台的构建目标
electron-builder 支持 macOS(dmg 和 zip)、Windows(NSIS 安装程序)以及 Linux(AppImage 和 deb)。您可以在一条构建命令中指定多个平台,也可以配置持续集成,让每个平台都在其原生运行器上构建,以获得最佳兼容性。
macOS 代码签名
macOS 要求使用 Apple Developer 证书进行代码签名,这样 Gatekeeper 才会允许用户打开应用而不显示安全警告。electron-builder 会在构建过程中从 macOS 钥匙串读取您的证书,并自动为所有二进制文件签名。
macOS 公证
除了代码签名之外,现代 macOS 还要求进行公证,也就是将应用提交给 Apple 的公证服务,由该服务扫描恶意软件并签发票据。electron-builder 可以通过 electron-notarize 自动完成公证;在 macOS 10.15 及更高版本上,如果没有公证,用户将无法打开应用。
Windows 代码签名
Windows 要求使用受信任的证书颁发机构(CA)签发的 Authenticode 证书,这样 SmartScreen 才会信任您的安装程序。未进行签名时,用户会看到“Windows 已保护你的电脑”警告。扩展验证(EV)证书可以立即消除该警告,而标准的 OV 证书则会随着时间推移逐步建立信任。
构建输出结构
构建成功后,electron-builder 会将特定平台的安装程序写入 dist/ 目录。您会在其中找到 macOS 的 DMG 或 zip、Windows 的 NSIS .exe,以及 Linux 的 AppImage 或 .deb,同时还会看到 latest.yml(或 latest-mac.yml)自动更新清单。
应用图标
Electron 应用需要使用各平台专用的图标格式:Linux 使用 512x512 的 PNG,macOS 使用 ICNS 文件(多分辨率),Windows 使用 ICO 文件(多分辨率)。electron-builder 可以通过 --icon 标志,根据单个 1024x1024 的 PNG 生成所有格式。
使用 electron-updater 自动更新
electron-updater 包与 electron-builder 集成后,可以提供自动更新功能。将构建结果发布到 GitHub Releases 或 S3 后,electron-updater 就能在应用启动时检查更新、在后台下载增量更新,并提示用户重启应用。
启动时检查更新
应用准备就绪后,在 main.js 中调用 autoUpdater.checkForUpdatesAndNotify()。electron-updater 会从您的发布目标获取 latest.yml 清单并比较版本;如果有可用更新,就会下载更新,并在准备安装时显示原生通知。
ASAR 归档
electron-builder 会将应用的 JavaScript 文件打包到单个 ASAR 归档中(类似 tar 文件),以便分发。这样可以减少文件系统查找次数,从而提升启动性能,也会增加直接查看源代码的难度,但并不能完全阻止查看。
从 ASAR 中解包原生模块
原生 Node.js 模块(.node 文件)无法从 ASAR 归档内部加载,必须解包到文件系统中。请在 electron-builder 中配置 asarUnpack,列出原生模块的匹配模式;这些模块会被放入归档旁边的 app.asar.unpacked 目录中。
macOS 公证要求
除了代码签名之外,为什么 macOS 分发还要求进行公证?
课程回顾
分发 Electron 应用需要配置 electron-builder 的构建目标,为 macOS(包括公证)和 Windows(Authenticode)进行代码签名,并可选择使用 electron-updater 设置自动更新。ASAR 归档会将应用打包以便分发,原生模块则会单独解包。完善的持续集成与持续交付流水线可以按平台自动完成这些步骤。
常见问题解答
「桌面平台的打包与分发」课时是免费的吗?
是的 — 「桌面平台的打包与分发」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 React Academy 课程的其余内容,请升级到 CoddyKit PRO。 React Academy 课程共包含 4 节课。
「桌面平台的打包与分发」这节课中我会学到什么?
使用 electron-builder 为 macOS、Windows 和 Linux 构建安装程序,并实现代码签名和自动更新。 你通过在浏览器中直接运行的动手代码来练习 React Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 React Academy 需要有经验吗?
无需任何先前经验。CoddyKit 上的 React Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 4 节课,共 4 节。
「桌面平台的打包与分发」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 React Academy 课中编写并运行代码吗?
能。每节 React Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。