CPack 拖放生成器

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。请参阅政策:policy:CMP0133。

备注

添加此选项是为了响应 macOS 12.0 弃用``hdiutil udifrez``命令以使其使用可选。 CPack 3.22 及以下版本始终使用 :variable:`CPACK_RESOURCE_FILE_LICENSE`（如果设置为非默认值）作为 DMG 许可证。

CPACK_DMG_SLA_DIR

在 3.5 版本加入.

存储不同语言的许可证和菜单文件的目录。设置此项会导致 CPack 为以下定义的每种语言查找 <language>.menu.txt 和 <language>.license.txt 或 <language>.license.rtf 文件 CPACK_DMG_SLA_LANGUAGES。如果此变量和 CPACK_RESOURCE_FILE_LICENSE 均已设置，CPack 将仅查找菜单文件并对所有语言使用相同的许可文件。如果 <language>.license.txt 和 <language>.license.rtf 都存在，则将使用 .txt 文件。

在 3.17 版本加入: RTF 支持。

CPACK_DMG_SLA_LANGUAGES

在 3.5 版本加入.

安装生成的 DMG 时提供许可协议的语言。一个菜单文件由 9 行文本组成。第一行是语言本身的名称，大写，英文（例如德语）。其他行是以下字符串的翻译：

  • 同意

  • 不同意

  • 打印

  • 节省...

  • 单击“同意”按钮即表示您同意许可协议的条款。

  • 软件许可协议

  • 无法保存此文本。磁盘可能已满或被锁定，或者文件可能被锁定。

  • 无法打印。确保您已经选择了一台打印机。

对于此列表中的每种语言，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-<组件>

CPACK_DMG_FILESYSTEM

在 3.21 版本加入.

默认:

高频+

文件系统格式。常用值是 APFS 和 HFS+。有关受支持格式的完整列表，请参阅“man hdiutil”。

CPACK_COMMAND_HDIUTIL

用于在 macOS 上操作磁盘映像文件的“hdiutil(1)”命令的路径。此变量可用于覆盖自动检测到的命令（或者如果自动检测未能找到它，则指定其位置）。

CPACK_COMMAND_SETFILE

用于在 macOS 上设置文件和目录扩展属性的“SetFile(1)”命令的路径。此变量可用于覆盖自动检测到的命令（或者如果自动检测未能找到它，则指定其位置）。

CPACK_COMMAND_REZ

用于在 macOS 上编译资源的“Rez(1)”命令的路径。此变量可用于覆盖自动检测到的命令（或者如果自动检测未能找到它，则指定其位置）。