Electron-Builder中pkg目标postinstall脚本参数变更问题分析

在Electron应用打包工具electron-builder的最新版本中，使用pkg目标打包时出现了一个关于postinstall脚本参数传递的行为变更。这个问题影响了那些依赖postinstall脚本进行安装后操作的应用开发者。

问题现象

在electron-builder 24.13.2及更高版本中，当使用pkg目标打包macOS应用时，postinstall脚本接收到的第二个参数($2)发生了变化。在之前版本中，这个参数会传递应用程序的安装目录路径(如/Applications)，而现在则传递了完整的应用包路径(如/Applications/YourApp.app)。

技术背景

postinstall脚本是macOS安装包(pkg)中的一个重要特性，它允许开发者在应用安装完成后执行自定义操作。根据macOS的规范，postinstall脚本会接收四个参数：

1. $0 - 脚本路径
2. $1 - 包路径
3. $2 - 目标位置
4. $3 - 目标卷

在electron-builder的24.13.2版本中，项目添加了对BundlePostInstallScriptPath和BundlePreInstallScriptPath键的支持，这导致脚本参数传递行为发生了变化。

问题根源

深入分析后发现，这个问题实际上是由于脚本被意外执行了两次造成的：

1. 第一次执行是针对整个应用程序包，此时$2参数为预期的/Applications
2. 第二次执行是针对组件(component)，此时$2参数变为/Applications/YourApp.app

这种双重执行行为是由于electron-builder对脚本文件扩展名的处理方式导致的。当脚本文件没有.sh扩展名时，系统会将其识别为"顶层postinstall脚本"并执行两次。

解决方案

目前有两种可行的解决方案：

1. 为postinstall脚本文件添加.sh扩展名
2. 在脚本中处理两种参数格式的情况

第一种方案更为简单可靠，只需确保脚本文件命名为postinstall.sh即可避免双重执行问题。

最佳实践建议

对于依赖postinstall脚本的electron-builder用户，建议：

1. 始终为安装脚本添加.sh扩展名
2. 在脚本中做好参数验证，确保能处理不同格式的路径
3. 测试脚本在不同electron-builder版本下的行为
4. 考虑使用绝对路径而非依赖参数，提高脚本的健壮性

这个问题提醒我们，在跨平台开发中，对安装后脚本的处理需要格外小心，特别是在不同打包工具版本间可能存在行为差异的情况下。