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

包含安装程序图标的可执行文件的路径。

提供安装应用程序方面帮助的网站 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 安装程序的完成页面上添加运行选项的可执行文件。

在 [application] 菜单中指定链接。这应包含一对 link link name 的列表。链接可以是 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 构造。