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 版本新增。
如果设置，则在安装过程中不显示包含许可证的页面。
- CPACK_NSIS_EXECUTABLE_PRE_ARGUMENTS¶
在 3.25 版本中新增。
此变量是用于添加到运行 nsis 脚本之前的参数的分号分隔列表。如果参数不以
/或-开头，它将自动为相应的参数添加一个。将运行的命令是makensis.exe <preArgs>... "nsisFileName.nsi" <postArgs>...
其中
<preArgs>...由CPACK_NSIS_EXECUTABLE_PRE_ARGUMENTS构建，而<postArgs>...由CPACK_NSIS_EXECUTABLE_POST_ARGUMENTS构建。
- CPACK_NSIS_EXECUTABLE_POST_ARGUMENTS¶
在 3.25 版本中新增。
此变量是用于附加到运行 nsis 脚本的参数的分号分隔列表。如果参数不以
/或-开头，它将自动为相应的参数添加一个。将运行的命令是makensis.exe <preArgs>... "nsisFileName.nsi" <postArgs>...
其中
<preArgs>...由CPACK_NSIS_EXECUTABLE_PRE_ARGUMENTS构建，而<postArgs>...由CPACK_NSIS_EXECUTABLE_POST_ARGUMENTS构建。
- CPACK_NSIS_CRC_CHECK¶
版本 4.2 中添加。
指定安装程序在允许安装之前是否对自身执行 CRC。此变量的允许值是
on、off和force。如果未指定，则默认行为是on。