CPack NSIS 生成器

CPack Nullsoft Scriptable Install System (NSIS) 生成器特定选项。

在 3.22 版本发生变更: NSIS 生成器需要 NSIS 3.03 或更新版本。

特定于 CPack NSIS 生成器的变量

以下变量特定于构建在 Windows Nullsoft 脚本安装系统上的图形安装程序。

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 Start Menu 链接假定它们在 bin 中,除非设置了这个变量。例如,如果您的可执行文件位于 exec 目录中,您可以将其设置为 exec

CPACK_NSIS_MUI_FINISHPAGE_RUN

指定一个可执行文件以添加一个选项以在 NSIS 安装程序的完成页面上运行。

在“[应用程序]”菜单中指定链接。这应该包含一对 link link name 的列表。该链接可以是 URL 或相对于安装前缀的路径。喜欢::

set(CPACK_NSIS_MENU_LINKS
    "doc/cmake-@CMake_VERSION_MAJOR@.@CMake_VERSION_MINOR@/cmake.html"
    "CMake Help" "https://cmake.org" "CMake Web Site")
CPACK_NSIS_UNINSTALL_NAME

在 3.17 版本加入.

指定要卸载版本的程序的名称。默认为“卸载”。

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 构建。