Electron-Builder中自定义安装目录失效问题分析

问题背景

在使用Electron-Builder构建Windows应用安装包时，开发者经常需要自定义默认安装路径。在早期版本(如20.x)中，通过NSIS脚本的preInit宏可以很好地实现这一需求。然而，在升级到较新版本(如24.x)后，这一功能出现了异常行为。

现象描述

当开发者按照官方文档建议，在NSIS脚本中使用preInit宏设置自定义安装路径时：

!macro preInit
    SetRegView 64
    WriteRegExpandStr HKLM "${INSTALL_REGISTRY_KEY}" InstallLocation "c:\MyApp"
    WriteRegExpandStr HKCU "${INSTALL_REGISTRY_KEY}" InstallLocation "c:\MyApp"
    SetRegView 32
    WriteRegExpandStr HKLM "${INSTALL_REGISTRY_KEY}" InstallLocation "c:\MyApp"
    WriteRegExpandStr HKCU "${INSTALL_REGISTRY_KEY}" InstallLocation "c:\MyApp"
!macroend

在旧版本中，应用会正确安装到指定路径(如c:\MyApp\myapp.exe)，但在新版本中却会在指定路径下额外创建产品名称目录(如c:\MyApp\MyCompany Super Product\myapp.exe)。

根本原因

经过分析，这个问题源于Electron-Builder 24.x版本中NSIS模板文件assistedInstaller.nsh的修改。关键变化在于instFilesPre函数的实现：

旧版本实现：

Function instFilesPre
  ${If} ${FileExists} "$INSTDIR\*"
    ${StrContains} $0 "${APP_FILENAME}" $INSTDIR
    ${If} $0 == ""
      StrCpy $INSTDIR "$INSTDIR\${APP_FILENAME}"
    ${endIf}
  ${endIf}
FunctionEnd

新版本实现：

Function instFilesPre
  ${StrContains} $0 "${APP_FILENAME}" $INSTDIR
  ${If} $0 == ""
    StrCpy $INSTDIR "$INSTDIR\${APP_FILENAME}"
  ${endIf}
FunctionEnd

新版本移除了对目录存在性的检查(${If} ${FileExists} "$INSTDIR*")，导致无论目录是否存在都会追加应用名称到安装路径。

影响范围

这个问题影响了所有使用Electron-Builder 24.x版本并尝试通过preInit宏自定义安装路径的项目。对于需要精确控制安装位置的企业级应用或需要特定目录结构的项目来说，这是一个严重的问题。

临时解决方案

目前开发者可以采取以下临时解决方案：

1. 暂时回退到Electron-Builder 20.x版本
2. 在preInit宏中设置路径时，预先考虑产品名称目录的存在
3. 自定义完整的NSIS安装脚本，完全接管路径处理逻辑

技术建议

对于需要严格安装路径控制的项目，建议：

1. 在项目中使用固定版本的Electron-Builder，避免自动升级带来的不兼容问题
2. 全面测试安装程序在各种环境下的行为，包括升级安装和全新安装场景
3. 考虑使用更高级的安装程序定制选项，如完全自定义NSIS脚本

总结

Electron-Builder作为流行的Electron应用打包工具，其行为变更可能会对现有项目产生重大影响。开发者在升级版本时应充分测试安装程序的关键功能，特别是路径处理这类基础功能。对于这个特定的安装路径问题，建议关注官方修复进展，同时评估临时解决方案对项目的影响。