CPack NSIS 生成器¶
CPack Nullsoft Scriptable Install System (NSIS) 生成器特有选项。
3.22 版本修改:NSIS 生成器需要 NSIS 3.03 或更高版本。
CPack NSIS 生成器特有变量¶
以下变量是 Windows Nullsoft Scriptable Install System 上构建的图形安装程序特有的。
- CPACK_NSIS_INSTALL_ROOT¶
NSIS 安装程序向最终用户显示的默认安装目录在此根目录下。向最终用户显示的完整目录为:
${CPACK_NSIS_INSTALL_ROOT}/${CPACK_PACKAGE_INSTALL_DIRECTORY}
- CPACK_NSIS_MUI_ICON¶
一个图标文件名。
*.ico
文件的名称,用作生成的安装程序的主图标。
- CPACK_NSIS_MUI_UNIICON¶
一个图标文件名。
*.ico
文件的名称,用作生成的卸载程序的主图标。
- CPACK_NSIS_INSTALLER_MUI_ICON_CODE¶
未记录。
- CPACK_NSIS_MUI_WELCOMEFINISHPAGE_BITMAP¶
3.5 版本新增。
用作 NSIS
MUI_WELCOMEFINISHPAGE_BITMAP
的位图文件名。
- CPACK_NSIS_MUI_UNWELCOMEFINISHPAGE_BITMAP¶
3.5 版本新增。
用作 NSIS
MUI_UNWELCOMEFINISHPAGE_BITMAP
的位图文件名。
- CPACK_NSIS_EXTRA_PREINSTALL_COMMANDS¶
在安装部分开始时添加的额外 NSIS 命令,在目标系统上可用安装树之前。
- CPACK_NSIS_EXTRA_INSTALL_COMMANDS¶
在安装部分结束时添加的额外 NSIS 命令,在目标系统上可用安装树之后。
- CPACK_NSIS_EXTRA_UNINSTALL_COMMANDS¶
在卸载部分添加的额外 NSIS 命令,在安装树从目标系统移除之前。
- CPACK_NSIS_COMPRESSOR¶
将传递给 NSIS
SetCompressor
命令的参数。
- CPACK_NSIS_ENABLE_UNINSTALL_BEFORE_INSTALL¶
首先询问是否卸载以前的版本。如果设置为
ON
,则安装程序将查找以前安装的版本,如果找到,则询问用户是否在继续安装之前卸载它。
- CPACK_NSIS_MODIFY_PATH¶
修改
PATH
开关。如果设置为ON
,则安装程序中会出现一个额外页面,允许用户选择是否将程序目录添加到系统PATH
变量。
- CPACK_NSIS_DISPLAY_NAME¶
在 控制面板 中的 Windows 应用和功能 中显示的显示名称字符串。
- CPACK_NSIS_PACKAGE_NAME¶
安装程序顶部显示的标题。
- CPACK_NSIS_INSTALLED_ICON_NAME¶
包含安装程序图标的可执行文件的路径。
- CPACK_NSIS_HELP_LINK¶
提供安装应用程序帮助的网站 URL。
- CPACK_NSIS_URL_INFO_ABOUT¶
提供有关应用程序更多信息的网站 URL。
- CPACK_NSIS_CONTACT¶
有关安装过程问题和意见的联系信息。
- CPACK_NSIS_<compName>_INSTALL_DIRECTORY¶
3.7 版本中新增。
指定组件
<compName>
的自定义安装目录,而不是$INSTDIR
。
- CPACK_NSIS_CREATE_ICONS_EXTRA¶
用于创建 开始菜单 快捷方式的额外 NSIS 命令。
- CPACK_NSIS_DELETE_ICONS_EXTRA¶
用于卸载 开始菜单 快捷方式的额外 NSIS 命令。
- CPACK_NSIS_EXECUTABLES_DIRECTORY¶
创建 NSIS 开始菜单 链接时,假设它们在
bin
中,除非设置此变量。例如,如果您的可执行文件在 exec 目录中,则可以将其设置为exec
。
- CPACK_NSIS_MUI_FINISHPAGE_RUN¶
指定一个可执行文件,以便在 NSIS 安装程序的完成页面上添加运行选项。
- CPACK_NSIS_MENU_LINKS¶
在
[应用程序]
菜单中指定链接。这应包含一对链接
链接名称
的列表。链接可以是 URL 或相对于安装前缀的路径。例如set(CPACK_NSIS_MENU_LINKS "doc/cmake-@CMake_VERSION_MAJOR@.@CMake_VERSION_MINOR@/cmake.html" "CMake Help" "https://cmake.com.cn" "CMake Web Site")
- CPACK_NSIS_UNINSTALL_NAME¶
在 3.17 版本中添加。
指定卸载该版本程序的名称。默认为
Uninstall
。
- CPACK_NSIS_WELCOME_TITLE¶
在 3.17 版本中添加。
欢迎页面顶部显示的标题。
- CPACK_NSIS_WELCOME_TITLE_3LINES¶
在 3.17 版本中添加。
在欢迎页面上将标题显示为 3 行而不是 2 行。
- CPACK_NSIS_FINISH_TITLE¶
在 3.17 版本中添加。
完成页面顶部显示的标题。
- CPACK_NSIS_FINISH_TITLE_3LINES¶
在 3.17 版本中添加。
在完成页面上将标题显示为 3 行而不是 2 行。
- CPACK_NSIS_MUI_HEADERIMAGE¶
在 3.17 版本中添加。
在安装程序页面标题中显示的图像。
- CPACK_NSIS_MANIFEST_DPI_AWARE¶
在 3.18 版本中新增。
如果设置,声明安装程序是 DPI 感知的。
- CPACK_NSIS_BRANDING_TEXT¶
在 3.20 版本中添加。
如果设置,更新安装窗口底部的文本。要将字符串设置为空白,请使用空格 (" ")。
- CPACK_NSIS_BRANDING_TEXT_TRIM_POSITION¶
在 3.20 版本中添加。
如果设置,将控件的大小裁剪为品牌文本字符串的大小。此变量允许的值为
LEFT
、CENTER
或RIGHT
。如果未指定,默认行为是LEFT
。
- CPACK_NSIS_EXECUTABLE¶
3.21 版本新增。
如果设置,指定 NSIS 可执行文件的名称。默认为
makensis
。
- CPACK_NSIS_IGNORE_LICENSE_PAGE¶
3.22 版本新增。
如果设置,在安装过程中不显示包含许可证的页面。