ScienceFair部署打包完整指南：electron-builder三平台构建、自动更新与代码签名实战

ScienceFair部署打包完整指南electron-builder三平台构建、自动更新与代码签名实战【免费下载链接】sciencefairThe futuristic, fabulous and free desktop app for working with scientific literature :microscope: :book:项目地址: https://gitcode.com/gh_mirrors/sc/sciencefairScienceFair 是一款开源的桌面端科学文献管理应用支持搜索、浏览和下载开放获取论文并通过 P2P 数据源同步学术内容。本文带你使用 electron-builder 完成它的三平台部署打包Windows 安装包、macOS DMG 镜像、Linux deb/rpm 包并搞懂自动更新与代码签名机制让你从零构建出可分发的正式版本。一、ScienceFair 项目一览打包之前先认识一下要构建的产品。ScienceFair 采用 Electron 架构界面由 choo 框架构建核心能力包括即时多源搜索、本地收藏管理和基于 Lens 的论文阅读器。搜索结果页支持同时查询本地收藏与远端数据源只需下载请求到的数据阅读器则用 Lens 渲染 JATS XML提供为科学论文优化的阅读体验二、环境准备Node 8 与两包结构ScienceFair 使用 Node8.x见 package.json 的engines字段并采用 electron-builder 推荐的两个 package.json 结构目录作用根目录 package.json存放开发依赖electron、electron-builder、electron-rebuild与打包脚本app/package.json存放应用运行时依赖hyperdrive、electron-updater 等准备步骤# 1. 克隆项目 git clone https://gitcode.com/gh_mirrors/sc/sciencefair # 2. 安装开发依赖根目录 npm install # 3. 安装应用依赖app 目录会自动触发 electron-rebuild 重编译原生模块 cd app npm install⚠️ 项目含leveldown、sodium-native等原生模块npmRebuild: true会在打包时自动重建因此构建机必须装好对应的编译工具链。三、electron-builder 三平台构建命令所有打包脚本都定义在根目录 package.json 中无需记忆冗长的 electron-builder 参数命令作用产物npm run pack仅打包不制作安装器--dir快速验证未打包目录npm run buildosx构建 macOS-mDMGnpm run buildlinux构建 Linux-ldeb rpmnpm run buildappveyor构建 Windows 双架构-w --ia32 --x64NSIS 安装包npm run buildall一次性构建 mac win linux-mwl三平台全套产物命名由 electron-builder.yml 中的artifactName: ${productName}-${os}-${arch}-${version}.${ext}控制例如ScienceFair-mac-x64-1.0.7.dmg版本号与 app/package.json 保持一致。四、关键配置解读electron-builder.ymlelectron-builder.yml 是整个部署打包的核心几个值得关注的配置appId: org.codeforscience.sciencefair—— 应用唯一标识自动更新依赖它匹配版本forceCodeSigning: true—— 强制代码签名macOS 构建必须配置签名证书否则直接失败后文详述asar: truecompression: maximum—— 资源打进 asar 归档并最大压缩减小体积files过滤规则—— 排除node_modules里的 README、测试文件与.bin避免安装包臃肿dmg背景图—— 使用 build/appdmg.png这就是下面 DMG 打开后的拖拽安装布局linux.target同时产出deb与rpm并设置分类为GNOME;GTK;Science;LiteratureLinux 桌面会自动归入科学类别win.nsis配置perMachine: true和oneClick: trueWindows 下生成一键安装器。五、跨平台构建在 mac 或 Linux 上打三平台包electron-builder 支持跨平台构建。项目内置了两个一键环境脚本省去手动装依赖的麻烦macOS 上构建需要 Homebrewsh scripts/setup_macos.sh # 安装 wine、mono构建 Windows 包及 gnu-tar、rpm 等Linux 上构建Debian/Ubuntush scripts/setup_linux.sh # 安装 icnsutils、wine、mono、rpm、bsdtar 等原理是Windows 安装器依赖 Wine Mono 的打包工具链Linux rpm 包依赖rpm命令macOS 图标转换依赖icnsutils。装好之后在 mac 或 Linux 一条npm run buildall即可产出三平台安装包 六、自动更新机制实战ScienceFair 的自动更新由 app/client/lib/updater.js 实现基于electron-updater依赖见 app/package.json。流程非常简洁应用启动时调用autoUpdater.checkForUpdates()检查新版本更新下载完成后弹出对话框提供立即安装重启与稍后两个选项用户确认后调用autoUpdater.quitAndInstall()完成安装。autoUpdater.on(update-downloaded, () { dialog.showMessageBox({ buttons: [Install and Relaunch, Later] }, response { if (response 0) autoUpdater.quitAndInstall() }) }) autoUpdater.checkForUpdates() 更新日志同时通过electron-log落盘便于排查。另外npm run doctor会启动 scripts/doctor.js内置 dat-doctor 用于检查 P2P 网络环境适合在部署验收阶段自测。七、代码签名与产物验收macOSforceCodeSigning: true要求配置 Developer ID 证书设置CSC_LINK/CSC_KEY_PASSWORD环境变量签名后用户打开 DMG 不会被 Gatekeeper 拦截WindowsNSIS 一键安装器在签名后同样可免除 SmartScreen 警告版本一致性发布前务必核对package.json与app/package.json的version字段一致并递增版本号否则自动更新无法触发。总结至此ScienceFair 的部署打包全流程已经打通环境准备 →npm run buildall三平台构建 → 产物命名与压缩 → 自动更新 → 代码签名。整套流程完全由 electron-builder.yml 与 npm scripts 驱动配置即文档方便二次开发与持续集成 【免费下载链接】sciencefairThe futuristic, fabulous and free desktop app for working with scientific literature :microscope: :book:项目地址: https://gitcode.com/gh_mirrors/sc/sciencefair创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考