electron-builder中NSIS配置项

冷不防 2023-02-23 08:27 7阅读 0赞

[https://www.jianshu.com/p/1701baa240fd][https_www.jianshu.com_p_1701baa240fd]

使用electron-builder打包electron项目，其中Windows提供了NSIS来自定义安装程序。  
找配置项都有哪些找了半天没找到汉化的，以下是搬运的官网的。  
*原地址：[https://www.electron.build/generated/nsisoptions][https_www.electron.build_generated_nsisoptions]*

*  `oneClick`= `true`布尔值-是创建一键安装程序还是辅助安装程序。
 *  `perMachine`= `false`布尔值-是否显示辅助安装程序的安装模式安装程序页面（选择按机器还是按用户）。或者是否始终按所有用户（每台计算机）安装。
    
    如果`oneClick`是`true`（默认）：是否按所有用户（每台计算机）安装。
    
    如果`oneClick`is `false`和`perMachine`is `true`：无安装模式安装程序页面，请始终按机器安装。
    
    如果`oneClick`是`false`和`perMachine`是`false`（默认）：安装模式安装程序页面。
 *  `allowElevation`= `true`布尔值- *仅辅助安装程序。*允许请求提升。如果为false，则用户将不得不以提升的权限重新启动安装程序。
 *  `allowToChangeInstallationDirectory`= `false`布尔值- *仅辅助安装程序。*是否允许用户更改安装目录。

--------------------

*  `installerIcon`字符串-安装程序图标的路径，相对于[构建资源][Link 1]或项目目录。默认为`build/installerIcon.ico`或应用程序图标。
 *  `uninstallerIcon`字符串-相对于[构建资源][Link 1]或项目目录的卸载程序图标的路径。默认为`build/uninstallerIcon.ico`或应用程序图标。
 *  `installerHeader`= `build/installerHeader.bmp`字符串- \*仅辅助安装程序。  
    `MUI_HEADERIMAGE`，相对于[构建资源][Link 1]或项目目录。
 *  `installerHeaderIcon`字符串- *仅一键安装程序。*相对于[构建资源][Link 1]或项目目录的标题图标（进度条上方）的路径。默认为`build/installerHeaderIcon.ico`或应用程序图标。
 *  `installerSidebar`字符串- *仅辅助安装程序。* `MUI_WELCOMEFINISHPAGE_BITMAP`，相对于[构建资源][Link 1]或项目目录。默认为`build/installerSidebar.bmp`或`${NSISDIR}\\Contrib\\Graphics\\Wizard\\nsis3-metro.bmp`。图像尺寸164×314像素。
 *  `uninstallerSidebar`字符串- *仅辅助安装程序。* `MUI_UNWELCOMEFINISHPAGE_BITMAP`，相对于[构建资源][Link 1]或项目目录。默认为`installerSidebar`选项或`build/uninstallerSidebar.bmp`或`build/installerSidebar.bmp`或`${NSISDIR}\\Contrib\\Graphics\\Wizard\\nsis3-metro.bmp`
 *  `uninstallDisplayName`= `${productName} ${version}`字符串-控制面板中的卸载程序显示名称。

--------------------

*  `include`字符串-NSIS包含定制安装程序脚本的路径。默认为`build/installer.nsh`。请参阅[自定义NSIS脚本][NSIS]。
 *  `script`字符串-用于自定义安装程序的NSIS脚本的路径。默认为`build/installer.nsi`。请参阅[自定义NSIS脚本][NSIS]。
 *  `license`字符串-EULA许可证文件的路径。默认为`license.txt`或`eula.txt`（或大写变体）。除了`txt,`rtf `and`html `supported (don't forget to use`target =“ \_ blank”\`以外的链接）。
    
    支持使用不同语言的多个许可证文件-使用lang后缀（例如`_de`，`_ru`）。例如，创建文件`license_de.txt`并`license_en.txt`在构建资源中。如果操作系统语言为德语，`license_de.txt`将显示。请参阅[语言代码到名称的][Link 2]映射。
    
    将通过用户OS语言选择适当的许可证文件。
 *  `artifactName`字符串- [工件文件名模板][Link 3]。默认为`${productName} Setup ${version}.${ext}`。
 *  `deleteAppDataOnUninstall`= `false`布尔值- *仅一键安装程序。*是否在卸载时删除应用程序数据。
 *  `differentialPackage`布尔值- `true`网络安装程序（`nsis-web`）的默认设置

--------------------

*  `displayLanguageSelector`= `false`布尔值-是否显示语言选择对话框。不推荐（默认情况下将使用OS语言检测到）。
 *  `installerLanguages`Array <String> | 字符串-安装程序语言（例如`en_US`，`de_DE`）。仅当您了解自己的工作和目的时才进行更改。
 *  `language`字符串[\-LCID Dec][-LCID Dec]，默认为`1033`（`English - United States`）。
 *  `multiLanguageInstaller`布尔值-是否创建多语言安装程序。默认为`unicode`选项值。
 *  `packElevateHelper`= `true`布尔值-是否打包提升的可执行文件（如果使用了每台机器安装程序，或者将来可以使用，则对于电子更新程序是必需的）。忽略是否`perMachine`设置为`true`。
 *  `preCompressedFileExtensions`= `[".avi", ".mov", ".m4v", ".mp4", ".m4p", ".qt", ".mkv", ".webm", ".vmdk"]`Array <字符串> | 字符串-将不被压缩的文件的文件扩展名。仅适用于`extraResources`和`extraFiles`文件。
 *  `unicode`= `true`Boolean-是否创建[Unicode安装程序][Unicode]。
 *  `guid`字符串-请参见[GUID与应用程序名称][GUID]。
 *  `warningsAsErrors`= `true`布尔值-如果`warningsAsErrors`为`true`（默认）：NSIS将把警告视为错误。如果`warningsAsErrors`是`false`：NSIS将允许警告。
 *  `runAfterFinish`= `true`布尔值-完成后是否运行已安装的应用程序。对于辅助安装程序，将删除相应的复选框。

--------------------

*  `createDesktopShortcut`= `true`布尔| “始终”-是否创建桌面快捷方式。设置为`always`是否在重新安装时也重新创建（即使被用户删除）。
 *  `createStartMenuShortcut`= `true`布尔值-是否创建开始菜单快捷方式。
 *  `menuCategory`= `false`布尔| 字符串-是否为开始菜单快捷方式和程序文件目录创建子菜单。如果为`true`，则将使用公司名称。或字符串值。
 *  `shortcutName`字符串-将用于所有快捷方式的名称。默认为应用程序名称。

作者：三川三一宁  
链接：https://www.jianshu.com/p/1701baa240fd  
来源：简书  
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

[https_www.jianshu.com_p_1701baa240fd]: https://www.jianshu.com/p/1701baa240fd
[https_www.electron.build_generated_nsisoptions]: https://links.jianshu.com/go?to=https%3A%2F%2Fwww.electron.build%2Fgenerated%2Fnsisoptions
[Link 1]: https://links.jianshu.com/go?to=https%3A%2F%2Fwww.electron.build%2Fconfiguration%2Fconfiguration%23MetadataDirectories-buildResources
[NSIS]: https://links.jianshu.com/go?to=https%3A%2F%2Fwww.electron.build%2Fgenerated%2Fnsisoptions%23custom-nsis-script
[Link 2]: https://links.jianshu.com/go?to=https%3A%2F%2Fgithub.com%2Fmeikidd%2Fiso-639-1%2Fblob%2Fmaster%2Fsrc%2Fdata.js
[Link 3]: https://links.jianshu.com/go?to=https%3A%2F%2Fwww.electron.build%2Fconfiguration%2Fconfiguration%23artifact-file-name-template
[-LCID Dec]: https://links.jianshu.com/go?to=https%3A%2F%2Fmsdn.microsoft.com%2Fen-au%2Fgoglobal%2Fbb964664.aspx
[Unicode]: https://links.jianshu.com/go?to=http%3A%2F%2Fnsis.sourceforge.net%2FDocs%2FChapter1.html%23intro-unicode
[GUID]: https://links.jianshu.com/go?to=https%3A%2F%2Fwww.electron.build%2Fconfiguration%2Fnsis%23guid-vs-application-name