如何自定义使用Tauri制作的程序安装器：修改文本、背景色等

Tauri默认使用NSIS（Windows）或DMG（macOS）制作安装器，以下以Windows平台的NSIS安装器为例，说明如何自定义各类元素：

1. 修改文本内容 #

方式一：通过tauri.conf.json配置基础文本 #

在src-tauri/tauri.conf.json的bundle.windows.nsis节点中，可直接配置部分核心文本相关项：

{
  "tauri": {
    "bundle": {
      "windows": {
        "nsis": {
          "license": "LICENSE", // 指定许可证文件，替换默认协议文本
          "language": "zh_CN", // 切换安装器默认语言，加载对应语言的内置文本
          "displayLanguageSelector": true // 显示语言选择器，允许用户自行选择安装语言
        }
      }
    }
  }
}

方式二：自定义NSIS脚本实现完全文本控制 #

若需要更细致的文本修改（如欢迎页标题、按钮文本等），需创建自定义NSIS脚本模板：

1. 在src-tauri目录下创建nsis/installer.nsh文件
2. 复制Tauri默认的NSIS脚本内容到该文件
3. 在脚本中修改对应的宏定义，替换文本内容：

# 修改欢迎页标题与描述
!define MUI_WELCOMEPAGE_TITLE "欢迎安装XX应用"
!define MUI_WELCOMEPAGE_TEXT "感谢您选择XX应用，点击下一步继续安装。\r\n\r\n安装过程可能需要几分钟，请耐心等待。"

# 修改按钮文本
!define MUI_BUTTONTEXT_INSTALL "立即安装"
!define MUI_BUTTONTEXT_FINISH "完成并启动"
!define MUI_BUTTONTEXT_CANCEL "取消"

4. 在tauri.conf.json中指定自定义脚本路径：

"nsis": {
  "template": "src-tauri/nsis/installer.nsh"
}

2. 修改背景颜色与图片 #

安装器侧边栏图片 #

在tauri.conf.json中直接指定侧边栏图片路径（需使用24位BMP格式，宽度建议为164px）：

"nsis": {
  "installerSidebar": "src-tauri/icons/installer-sidebar.bmp"
}

背景颜色 #

在自定义NSIS脚本中添加宏定义设置背景色（使用十六进制RGB值）：

# 设置安装器整体背景色
!define MUI_BGCOLOR 0x2c3e50
# 设置欢迎页背景色
!define MUI_WELCOMEPAGE_BGCOLOR 0x34495e

步骤页面图片 #

在自定义脚本中指定各步骤的页面图片（如欢迎页、完成页）：

!define MUI_WELCOMEPAGE_BITMAP "src-tauri/icons/welcome.bmp"
!define MUI_FINISHPAGE_BITMAP "src-tauri/icons/finish.bmp"

3. 其他元素自定义 #

• 安装路径：在tauri.conf.json中设置默认安装路径，或在脚本中修改InstallDir：

  "nsis": {
    "installLocation": "$PROGRAMFILES/XX应用"
  }
  

• 图标：替换安装器、卸载器的图标：

  "nsis": {
    "installerIcon": "src-tauri/icons/installer.ico",
    "uninstallerIcon": "src-tauri/icons/uninstaller.ico",
    "installerHeaderIcon": "src-tauri/icons/header.ico"
  }
  

• 自定义安装步骤：在NSIS脚本中添加自定义页面，比如选择组件、创建快捷方式选项等，可参考NSIS官方文档扩展逻辑。

注意：macOS平台的DMG安装器自定义逻辑不同，需通过bundle.macos.dmg配置或自定义DMG脚本实现，核心思路类似——替换资源文件与修改配置项。

内容的提问来源于stack exchange，提问作者Arthur de Araujo Neves