You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 

2.4 KiB

打包、更新与平台支持

应用身份

pnpm rename my-desktop "My Desktop" com.example.desktop
pnpm install

app.config.json 的 name/productName/appId 供主进程与 electron-builder 共同读取。更新源留空时不启用更新,也不访问任何模板作者服务器。正式发布前设置自己的图标、版本、许可证、支持链接和签名配置。

构建

pnpm package 生成当前平台的未安装目录。pnpm dist 默认 Windows NSIS、macOS DMG、Linux AppImage。推荐各自在目标系统构建,尤其是含原生 SQLite 的产物;CI 已准备三平台验证流程。

原生依赖使用 electron-builder 安装与打包时检查。SQLite 13 提供 Node-API 预构建;pnpm 禁止其隐式 node-gyp,避免支持的桌面平台为了空构建而要求本机编译器。其他原生模块或预构建不覆盖的平台可能仍需编译工具。遇到原生模块问题执行 pnpm rebuild。包管理器默认使用官方 registry;中国网络可以按本机环境设置 Electron 下载镜像,仓库不强制全体用户使用区域镜像。

Windows 安装包默认未签名。macOS 分发需要 Developer ID 签名、notarization 与必要的 entitlements。应用模板不能替代证书或发布账号。使用平台 CI secret 配置 electron-builder 的 CSC_LINK、CSC_KEY_PASSWORD 等变量,不提交证书或密码。

更新 feed

在 app.config.json 设置 updateUrl 为自己的 HTTPS 发布目录。electron-builder 会据此生成 publish 配置,运行时 UpdateService 使用相同地址。构建完成后发布安装包与对应的 latest*.yml/blockmap 文件。

模板使用 electron-updater 的平台 autoUpdater:Windows NSIS、macOS 的更新产物和 Linux AppImage 都需要正确配置发布格式。macOS 更新需要额外 ZIP 产物,启用 macOS 更新时将 mac.target 改为 ['dmg', 'zip']。Linux 应从实际 AppImage 中测试更新;解压目录不能代表安装后的更新行为。

更新默认手动触发,autoDownload/autoInstallOnAppQuit/allowDowngrade/allowPrerelease 均为 false。安装前使用主进程原生确认。发布源的可用性、签名一致性和真实升级路径要通过发布环境验证。

验证范围

本地运行记录见 docs/validation.md。仓库包含 Windows/macOS/Linux CI 定义,但 CI 文件存在不代表已经在远程平台运行。真实更新依赖自己的 feed 和签名产物;默认禁用状态可以本地验证。