Electron 发布与部署
Electron 中的发布与部署
发布（Release）与部署（Deployment）是 Electron 应用从开发完成到交付用户手中的最后环节。主要涉及：生成版本化的安装包、上传到分发渠道、实现自动更新，以及在生产环境中稳定运行。以下基于 2025 年最新实践（electron-builder + electron-updater + 主流平台）进行总结。
1.发布流程概述
典型发布流程：
- 递增版本号（package.json 的
version） - 构建前端资源（Vite/Webpack 等）
- 使用打包工具生成安装包（.exe/.dmg/.AppImage 等）
- 代码签名与公证（生产必备）
- 上传安装包到分发服务器（GitHub Releases、S3、私有服务器等）
- 触发自动更新检测（用户下次启动时提示更新）
2.主流分发渠道与自动更新方案
| 方案 | 适用平台 | 优点 | 缺点/要求 | 配置难度 |
|---|---|---|---|---|
| GitHub Releases | Win/mac/Linux | 最简单、私有仓库也支持、免费、electron-updater 原生支持 | 需要 GitHub 账号，发布频率受限（rate limit） | ★☆☆☆☆ |
| S3 + CloudFront | Win/mac/Linux | 高性能 CDN、可控权限、适合企业 | 需要 AWS 账号、配置签名 URL | ★★☆☆☆ |
| Azure Blob / Google Cloud | Win/mac/Linux | 类似 S3，适合对应云用户 | 配置复杂 | ★★★☆☆ |
| 自建服务器（如 Nutstore） | Win/mac/Linux | 完全可控、国内访问快 | 需要维护服务器、HTTPS 证书 | ★★★★☆ |
| 应用商店分发 | macOS/Windows | Mac App Store、Microsoft Store（侧载或商店上架） | 严格审核、需付费证书、无法自动更新（商店版） | ★★★★★ |
2025 年推荐：GitHub Releases + electron-updater（90% 项目首选）。
3.electron-updater 自动更新配置（关键代码）
安装：
npminstallelectron-updater主进程实现（main.js）：
const{app,autoUpdater,dialog}=require('electron');const{electronUpdater}=require('electron-updater');// 可选：设置日志electronUpdater.logger=require('electron-log');autoUpdater.on('checking-for-update',()=>{console.log('正在检查更新...');});autoUpdater.on('update-available',(info)=>{dialog.showMessageBox({type:'info',title:'发现新版本',message:`发现新版本${info.version}，是否立即下载？`,buttons:['是','稍后']}).then((res)=>{if(res.response===0)autoUpdater.downloadUpdate();});});autoUpdater.on('update-downloaded',()=>{dialog.showMessageBox({title:'更新已就绪',message:'更新下载完成，应用将重启以应用更新。',buttons:['立即重启']}).then(()=>{autoUpdater.quitAndInstall();});});// 应用就绪后检查更新（推荐延迟几秒，避免启动卡顿）app.whenReady().then(()=>{setTimeout(()=>{autoUpdater.checkForUpdatesAndNotify();// 或 checkForUpdates()},5000);});package.json publish 配置（与 electron-builder 结合）：
"build":{"publish":[{"provider":"github","owner":"your-username","repo":"your-repo","private":false,// private: true 也支持（需 token）"releaseType":"release"// draft/release/prerelease}]}4.CI/CD 自动化发布（强烈推荐）
使用 GitHub Actions 实现一键发布：
示例 workflow（.github/workflows/release.yml）：
name:Releaseon:push:tags:-'v*'jobs:build:runs-on:${{matrix.os}}strategy:matrix:os:[macos-latest,windows-latest,ubuntu-latest]steps:-uses:actions/checkout@v4-name:Setup Nodeuses:actions/setup-node@v4with:node-version:20-run:npm ci-run:npm run build:frontend# 构建 React/Vite 等-name:Build & Publishenv:GITHUB_TOKEN:${{secrets.GITHUB_TOKEN}}# macOS 公证APPLE_ID:${{secrets.APPLE_ID}}APPLE_ID_PASSWORD:${{secrets.APPLE_ID_PASSWORD}}# Windows 签名CSC_LINK:${{secrets.CSC_LINK}}CSC_KEY_PASSWORD:${{secrets.CSC_KEY_PASSWORD}}run:npm run release# electron-builder --publish always触发方式：打 taggit tag v1.2.0 && git push --tags
5.生产部署注意事项
- 版本递增：每次发布必须提升
package.json的version，否则更新检测失败。 - 增量更新：electron-updater 支持差分更新（macOS/Linux 更明显），可大幅减少下载体积。
- 静默更新：可用
checkForUpdates()+ 后台下载 + 手动提示。 - 错误处理：捕获
error事件，记录日志，避免更新失败崩溃。 - 多渠道发布：可同时配置多个 publish provider，按平台选择。
- 企业内网部署：禁用自动更新，手动分发安装包，或自建更新服务器。
6.常见问题与解决方案
- 更新卡在“下载中”：检查服务器是否支持 Range 请求（GitHub 支持）。
- macOS 公证失败：确保 Hardened Runtime 和正确 entitlements。
- Windows SmartScreen 警告：必须使用 EV 代码签名证书。
- Linux 更新复杂：AppImage + 自建服务器最可靠。
完整的发布与部署链路：GitHub + electron-builder + electron-updater + GitHub Actions是当前最成熟、最高效的组合，能实现从代码提交到用户自动更新的全自动化。如果你计划上架应用商店或有企业级部署需求（如离线更新、自定义 CDN），可以提供更多细节，我可以给出针对性方案！