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¶

指定 [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 构建。

CPack NSIS 生成器¶

特定于 CPack NSIS 生成器的变量¶

目录

上一主题

下一主题

此页面