Electron Forge中Windows版本号处理问题解析

问题背景

在使用Electron Forge构建Windows平台应用安装包时，开发者可能会遇到一个棘手的问题：当应用版本号包含预发布标签（如2.3.0-beta）时，生成的MSI安装包安装后应用无法正常启动。这个问题的根源在于Electron Forge对Windows版本号的特殊处理方式。

问题现象

当开发者在package.json中设置带有预发布标签的版本号时：

"version": "2.3.0-beta"

使用Electron Forge的@electron-forge/maker-wix制作MSI安装包时，会看到警告信息：

WARNING: WiX distributables do not handle prerelease information in the app version, removing it from the MSI

安装后，应用目录会被命名为app-2.3.0.0而非预期的app-2.3.0-beta，导致应用启动器无法正确找到并启动应用。

技术分析

版本号处理机制

Electron Forge在构建过程中会对Windows平台的版本号进行特殊处理，主要涉及两个关键组件：

1. Electron Forge的版本号规范化
   normalizeWindowsVersion函数会将版本号中的预发布标签移除，并强制添加.0后缀。例如：

   • 输入：2.3.0-beta
   • 输出：2.3.0.0

2. electron-wix-msi的实际处理
   这个底层库实际上已经具备处理预发布版本的能力，它会：

   • 保留原始语义化版本号用于应用目录命名
   • 生成符合Windows MSI规范的版本号（major.minor.build格式）

问题根源

Electron Forge在调用electron-wix-msi之前就进行了版本号处理，导致：

1. 传递给electron-wix-msi的已经是修改后的版本号（2.3.0.0）
2. 应用目录被错误命名为app-2.3.0.0
3. 启动器（StubExecutable）无法识别这个非标准语义化版本号

解决方案

推荐方案

最彻底的解决方案是修改Electron Forge的代码，移除对版本号的预处理，让electron-wix-msi自行处理版本号转换。

临时解决方案

开发者可以在Forge配置中显式指定版本号，绕过自动处理：

// forge.config.js
const packageJSON = require('./package.json')

module.exports = {
  makers: [
    new MakerWix({
      version: packageJSON.version, // 显式传递原始版本号
    }),
  ],
}

技术建议

1. 版本号规范
   虽然Windows MSI安装包只支持major.minor.build格式的版本号，但应用目录命名仍应保持语义化版本规范。

2. 组件职责划分
   版本号转换应由专门的组件（electron-wix-msi）处理，上层工具不应提前干预。

3. 兼容性考虑
   工具链应确保生成的安装包在各种版本号格式下都能正常工作，特别是考虑到现代JavaScript生态普遍使用语义化版本控制。

总结

这个问题揭示了构建工具链中组件间协作的重要性。Electron Forge出于兼容性考虑对版本号进行了处理，但实际上底层工具已经具备更完善的处理能力。开发者在使用时需要注意这一细节，通过配置绕过预处理，或等待官方修复此问题。