Electron Builder v26.0.0 版本深度解析：重大变更与新特性解读

Electron Builder 是一个强大的 Electron 应用程序打包工具，它能够将 Electron 应用打包成各种平台的可执行文件，包括 Windows、macOS 和 Linux。作为 Electron 生态系统中最重要的工具之一，Electron Builder 简化了开发者的打包和分发流程。

重大变更

macOS DMG 格式调整

v26.0.0 版本移除了在非 ARM64 Mac 上构建 HFS+ DMG 的条件逻辑。这一变更源于苹果在 macOS 15.2 中正式弃用了 HFS+ 文件系统。开发者需要注意，新版本将统一使用更现代的 APFS 文件系统格式来构建 DMG 镜像，这可能会影响一些依赖旧文件系统的兼容性场景。

配置项重构

本次更新对 Windows 和 macOS 的配置选项进行了重构：

1. Windows 平台的签名配置从 winOptions 迁移到了 win.signtoolOptions，这一变化使得配置结构更加清晰，同时为未来添加 Azure 相关选项预留了空间。

2. macOS 的公证(notarize)选项已被完全移除，取而代之的是推荐使用环境变量进行配置。环境变量不仅更安全，还能更好地与 CI/CD 系统集成。

.desktop 文件增强

Linux 平台的 .desktop 文件配置得到了增强，现在支持添加额外的条目，如 [Desktop Actions <actionName>]。这一变化要求开发者将原有的 desktop 属性从简单的键值对升级为对象结构，为未来可能的扩展提供了更好的支持。

Node 模块包含逻辑改进

新版本改进了对项目中 node_modules 的处理逻辑，现在能够正确地包含位于子目录中的 node_modules。这一改进特别适合使用 monorepo 结构或具有复杂依赖关系的项目。

新特性

PowerShell 检测与 Azure 签名

v26.0.0 增加了对 PowerShell(pwsh)的自动检测功能，这使得在 Docker 环境中使用 Azure 可信签名成为可能。这一改进简化了在容器化构建环境中的签名流程。

Keygen 自托管支持

对于使用 Keygen 进行应用分发的开发者，新版本增加了 host 属性，支持连接到自托管的 Keygen 实例。这一功能为企业用户提供了更大的灵活性。

AppArmor 支持

Linux 平台新增了对 AppArmor 的支持，包括模板配置文件和相应的配置属性。AppArmor 是 Linux 的安全模块，能够限制程序的能力范围，这一功能增强了 Electron 应用在 Linux 上的安全性。

完全自定义 AppxManifest.xml

Windows 平台的 AppX 打包现在支持完全自定义 AppxManifest.xml 文件。这一功能为需要精细控制 UWP 应用清单的高级用户提供了可能。

通用 Windows 安装程序控制

新增了禁用构建通用 Windows 安装程序的选项。对于只需要特定架构安装包的项目，这一功能可以减少构建时间和输出文件大小。

Electron Fuses 集成

v26.0.0 引入了与 @electron/fuses 的集成。Electron Fuses 是 Electron 团队提供的一套安全开关，允许开发者禁用某些 Electron 特性以增强应用安全性。

官方 ASAR 打包支持

本次更新将 ASAR 打包功能迁移到了官方的 electron/asar 包。这一变化意味着 Electron Builder 现在使用 Electron 官方维护的 ASAR 实现，提高了兼容性和稳定性。

electronDist Hook

electronDist 配置项现在被重构为一个标准的 Electron Builder Hook。这一变化使得自定义 Electron 分发位置的逻辑更加灵活，可以更好地集成到构建流程中。

pacman 自动更新支持

对于 Arch Linux 用户，新版本增加了 pacman 包的自动更新支持。这一功能完善了 Linux 平台下的自动更新生态。

S3 路径风格支持

新增了 forcePathStyle 选项到 S3 配置中。这一功能对于使用某些兼容 S3 API 的对象存储服务(如 MinIO)特别有用。

问题修复与优化

除了上述新特性，v26.0.0 还包含大量问题修复和优化：

1. 修复了 Windows 平台上包含空格的文件的 Azure 签名问题
2. 改进了符号链接的安全性检查
3. 优化了并发签名逻辑，避免 Azure 资源锁定
4. 修复了跨平台构建时的 ASAR 完整性文件路径问题
5. 移除了 NSIS 安装程序中的非正式俄语消息
6. 改进了对 npm workspaces 的支持
7. 修复了 ASAR 文件在 extraResources 中的完整性计算问题
8. 优化了文件复制和符号链接创建的性能

升级建议

对于计划升级到 v26.0.0 的开发者，建议特别注意以下几点：

1. 检查 macOS 公证配置是否已迁移到环境变量
2. 评估 HFS+ DMG 格式移除对现有用户的影响
3. 对于复杂的 .desktop 文件需求，更新配置结构
4. 考虑使用新的 Electron Fuses 功能增强应用安全性
5. 测试 node_modules 包含逻辑变化对项目的影响

Electron Builder v26.0.0 通过这一系列重大变更和新特性，进一步巩固了其作为 Electron 应用打包首选工具的地位，为开发者提供了更强大、更安全的构建体验。