在electron-builder中实现NSIS安装后执行自定义脚本

在electron-builder项目中使用NSIS打包Windows应用时，开发者经常需要在安装完成后执行一些自定义操作。本文将详细介绍如何正确实现这一需求。

问题背景

当使用electron-builder的NSIS目标打包应用程序时，开发者可能会尝试在安装完成后执行自定义脚本。常见的使用场景包括：

• 显示安装完成提示
• 执行注册表操作
• 启动应用程序
• 创建快捷方式等

常见误区

许多开发者最初会尝试使用以下两种方式：

1. 使用Section区块：

Section -postInstall
; 自定义命令
SectionEnd

2. 使用Section.onInstSuccess：

Section .onInstSuccess
; 自定义命令
SectionEnd

然而，这两种方式都存在问题。第一种方式会导致命令在安装开始前就执行，第二种方式则不是NSIS的标准语法。

正确实现方式

NSIS提供了回调函数机制，正确的做法是使用Function.onInstSuccess：

Function .onInstSuccess
; 这里放置安装成功后要执行的命令
MessageBox MB_OK "安装成功完成！"
; 其他自定义命令...
FunctionEnd

技术原理

NSIS的安装过程遵循特定的生命周期，其中.onInstSuccess是一个特殊的回调函数，它会在以下条件满足时自动调用：

1. 所有文件已成功复制到目标位置
2. 所有注册表操作已完成
3. 所有快捷方式已创建
4. 用户点击了"完成"按钮

这个回调函数是NSIS的标准特性，确保开发者可以在正确的时间点执行后安装操作。

实际应用建议

在实际项目中，建议在electron-builder的配置文件中通过nsis字段添加自定义脚本：

{
  "nsis": {
    "include": "custom_installer.nsh"
  }
}

然后在custom_installer.nsh文件中定义.onInstSuccess函数。这种方式保持了配置的整洁性，也便于维护。

注意事项

1. 在回调函数中执行的命令应该有错误处理机制
2. 避免执行耗时操作，以免影响用户体验
3. 确保命令有足够的权限执行
4. 考虑静默安装场景下的兼容性

通过正确使用NSIS的回调函数机制，开发者可以灵活地在electron-builder打包的应用中实现各种安装后操作。