如何在Tauri中配置NSIS安装器,实现自定义安装资源与功能?
Tauri NSIS 安装器自定义配置指南
完全可以,Tauri 支持直接在项目配置文件中定义 NSIS 安装器的所有参数,和 Electron 在 package.json 中配置构建参数的逻辑一致,无需手动编写原生 NSIS 脚本。
所有 Windows 安装器相关配置都存放在项目src-tauri目录下的tauri.conf.json(Tauri 1.x)或Tauri.toml(Tauri 2.x)的tauri > bundle > windows > nsis节点下,对应功能的配置方法如下:
修改安装器与应用图标
- 若要修改 NSIS 安装包本身的图标,配置
installerIcon字段,值为.ico格式文件的相对路径(相对于src-tauri目录),建议使用包含多尺寸规格的ico文件。 - 若要修改安装完成后桌面快捷方式的应用图标,配置
tauri > bundle > icon字段,填入对应ico文件路径即可。
示例配置:
{ "tauri": { "bundle": { "icon": ["./icons/app.ico"], "windows": { "nsis": { "installerIcon": "./icons/installer.ico" } } } } }
修改安装向导横幅图片
NSIS 向导有两个可自定义的图片配置项:
headerImage:安装向导每一步顶部的窄横幅,要求为 150*57 像素的 BMP 格式图片welcomeImage:安装完成页的侧边宽横幅,要求为 164*314 像素的 BMP 格式图片
示例配置:
"nsis": { "headerImage": "./assets/install-header.bmp", "welcomeImage": "./assets/install-finish.bmp" }
控制安装完成后是否自动运行应用
配置runAfterInstall布尔字段即可:
- 设为
true:安装完成后默认勾选自动运行选项,用户确认后直接启动应用 - 设为
false:安装页不会显示自动运行选项,安装完成后直接退出向导
示例配置:
"nsis": { "runAfterInstall": false }
所有配置修改完成后,直接执行tauri build命令构建安装包即可生效,无需额外调整其他参数。
内容的提问来源于stack exchange,提问作者d-feverx
相关产品推荐
相关产品推荐

