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 安装程序的完成页面上添加运行选项。

[应用程序] 菜单中指定链接。这应包含一对 链接 链接名称 的列表。链接可以是 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 版本中添加。

如果设置,将控件的大小裁剪为品牌文本字符串的大小。此变量允许的值为 LEFTCENTERRIGHT。如果未指定,默认行为是 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 构造。