CPack DragNDrop 產生器

DragNDrop CPack 產生器 (macOS) 建立 DMG 映像檔。

CPack DragNDrop 產生器特定的變數

以下變數是 macOS 上建置的 DragNDrop 安裝程式特有的

CPACK_DMG_VOLUME_NAME

產生的磁碟映像檔的卷宗名稱。

預設:

CPACK_PACKAGE_FILE_NAME

CPACK_DMG_FORMAT

磁碟映像檔格式。

預設:

UDZO

常見的值為 UDRO (UDIF 唯讀)、UDZO (UDIF zlib 壓縮) 或 UDBZ (UDIF bzip2 壓縮)。請參閱 hdiutil(1) 以取得關於其他可用格式的更多資訊。

CPACK_DMG_DS_STORE

自訂 .DS_Store 檔案的路徑。此 .DS_Store 檔案可用於指定 Finder 視窗位置/幾何形狀和佈局 (例如隱藏的工具列、圖示的放置位置等)。此檔案必須由 Finder 產生 (手動或透過 AppleScript),使用一般的資料夾,然後可以從中提取 .DS_Store 檔案。

CPACK_DMG_DS_STORE_SETUP_SCRIPT

在版本 3.5 中新增。

自訂 AppleScript 檔案的路徑。此 AppleScript 用於產生 .DS_Store 檔案,該檔案指定 Finder 視窗位置/幾何形狀和佈局 (例如隱藏的工具列、圖示的放置位置等)。透過指定自訂 AppleScript,無需使用 CPACK_DMG_DS_STORE,因為由 AppleScript 產生的 .DS_Store 將會被打包。

CPACK_DMG_BACKGROUND_IMAGE
預設:

要用作背景圖片的圖片檔案路徑。此檔案將被複製到 .background/background.<ext>,其中 <ext> 是原始圖片檔案副檔名。背景圖片會在執行 CPACK_DMG_DS_STORE_SETUP_SCRIPT 或安裝 CPACK_DMG_DS_STORE 之前安裝到映像檔中。預設情況下,未設定背景圖片。

在版本 3.6 中新增。

預設行為是在 DMG 中包含 /Applications 的符號連結。將此選項設定為 ON 以避免新增符號連結。

CPACK_DMG_SLA_USE_RESOURCE_FILE_LICENSE

在版本 3.23 中新增。

預設:

關閉

控制 CPACK_RESOURCE_FILE_LICENSE (如果設定為非預設值) 是否用作掛載 DMG 時提供的授權協議。如果未設定 CPACK_DMG_SLA_USE_RESOURCE_FILE_LICENSE,則 cpack(1) 預設為關閉。

在使用 CPack 模組產生 CPackConfig.cmake 的 CMake 專案中,專案必須明確啟用 CPACK_DMG_SLA_USE_RESOURCE_FILE_LICENSE 才能啟用 SLA。請參閱政策 CMP0133

注意

此選項是在 macOS 12.0 棄用 hdiutil udifrez 命令後新增的,使其使用成為可選。CPack 3.22 及更早版本始終使用 CPACK_RESOURCE_FILE_LICENSE (如果設定為非預設值) 作為 DMG 授權。

CPACK_DMG_SLA_DIR

在版本 3.5 中新增。

儲存不同語言的授權和選單檔案的目錄。設定此選項會導致 CPack 尋找在 CPACK_DMG_SLA_LANGUAGES 中定義的每種語言的 <language>.menu.txt<language>.license.txt<language>.license.rtf 檔案。如果同時設定此變數和 CPACK_RESOURCE_FILE_LICENSE,CPack 將僅尋找選單檔案,並對所有語言使用相同的授權檔案。如果 <language>.license.txt<language>.license.rtf 都存在,則將使用 .txt 檔案。

在版本 3.17 中新增: RTF 支援。

CPACK_DMG_SLA_LANGUAGES

在版本 3.5 中新增。

在掛載產生的 DMG 時提供授權協議的語言。選單檔案包含 9 行文字。第一行是以英文 (例如 German) 大寫的語言名稱本身。其他行是以下字串的翻譯

  • 同意

  • 不同意

  • 列印

  • 儲存...

  • 當您點擊「同意」按鈕時,即表示您同意授權協議的條款。

  • 軟體授權協議

  • 此文字無法儲存。磁碟可能已滿或已鎖定,或檔案可能已鎖定。

  • 無法列印。請確保您已選取印表機。

對於此清單中的每種語言,CPack 將嘗試在 CPACK_DMG_SLA_DIR 變數指定的目錄中尋找檔案 <language>.menu.txt<language>.license.txt

CPACK_DMG_<component>_FILE_NAME

在版本 3.17 中新增。

<component> 作為其自己的 DMG 打包時的檔案名稱 (CPACK_COMPONENTS_GROUPING 設定為 IGNORE)。

預設:

CPACK_PACKAGE_FILE_NAME-<component>

CPACK_DMG_FILESYSTEM

在版本 3.21 中新增。

預設:

HFS+

檔案系統格式。常見的值為 APFSHFS+。請參閱 man hdiutil 以取得完整支援格式列表。

CPACK_COMMAND_HDIUTIL

hdiutil(1) 命令的路徑,用於在 macOS 上操作磁碟映像檔。此變數可用於覆寫自動偵測到的命令 (或在自動偵測找不到命令時指定其位置)。

CPACK_COMMAND_SETFILE

SetFile(1) 命令的路徑,用於在 macOS 上設定檔案和目錄的擴展屬性。此變數可用於覆寫自動偵測到的命令 (或在自動偵測找不到命令時指定其位置)。

CPACK_COMMAND_REZ

Rez(1) 命令的路徑,用於在 macOS 上編譯資源。此變數可用於覆寫自動偵測到的命令 (或在自動偵測找不到命令時指定其位置)。