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.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 建構而來。