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 安裝程式的完成頁面上新增執行選項的可執行檔。

在 [應用程式] 功能表中指定連結。這應包含一對 link 連結 名稱。連結可以是 URL 或相對於安裝字首的路徑。例如

set(CPACK_NSIS_MENU_LINKS
    "doc/cmake-@CMake_VERSION_MAJOR@.@CMake_VERSION_MINOR@/cmake.html"
    "CMake Help" "https://cmake.dev.org.tw" "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 建構。