CPack DragNDrop Generator¶
The DragNDrop CPack generator (macOS) creates a DMG image.
Variables specific to CPack DragNDrop generator¶
The following variables are specific to the DragNDrop installers built on macOS:
- CPACK_DMG_VOLUME_NAME¶
- The volume name of the generated disk image. - Default:
 
- CPACK_DMG_FORMAT¶
- The disk image format. - Default:
- UDZO
 - Common values are - UDRO(UDIF read-only),- UDZO(UDIF zlib-compressed) or- UDBZ(UDIF bzip2-compressed). Refer to- hdiutil(1)for more information on other available formats.
- CPACK_DMG_DS_STORE¶
- Path to a custom - .DS_Storefile. This- .DS_Storefile can be used to specify the Finder window position/geometry and layout (such as hidden toolbars, placement of the icons etc.). This file has to be generated by the Finder (either manually or through AppleScript) using a normal folder from which the- .DS_Storefile can then be extracted.
- CPACK_DMG_DS_STORE_SETUP_SCRIPT¶
- Added in version 3.5. - Path to a custom AppleScript file. This AppleScript is used to generate a - .DS_Storefile which specifies the Finder window position/geometry and layout (such as hidden toolbars, placement of the icons etc.). By specifying a custom AppleScript there is no need to use- CPACK_DMG_DS_STORE, as the- .DS_Storethat is generated by the AppleScript will be packaged.
- CPACK_DMG_BACKGROUND_IMAGE¶
- Default:
 - Path to an image file to be used as the background. This file will be copied to - .background/- background.<ext>, where- <ext>is the original image file extension. The background image is installed into the image before- CPACK_DMG_DS_STORE_SETUP_SCRIPTis executed or- CPACK_DMG_DS_STOREis installed. By default no background image is set.
- CPACK_DMG_DISABLE_APPLICATIONS_SYMLINK¶
- Added in version 3.6. - Default behavior is to include a symlink to - /Applicationsin the DMG. Set this option to- ONto avoid adding the symlink.
- CPACK_DMG_SLA_USE_RESOURCE_FILE_LICENSE¶
- Added in version 3.23. - Default:
- OFF
 - Control whether - CPACK_RESOURCE_FILE_LICENSE, if set to a non-default value, is used as the license agreement provided when mounting the DMG. If- CPACK_DMG_SLA_USE_RESOURCE_FILE_LICENSEis not set,- cpack(1)defaults to off.- In a CMake project that uses the - CPackmodule to generate- CPackConfig.cmake,- CPACK_DMG_SLA_USE_RESOURCE_FILE_LICENSEmust be explicitly enabled by the project to activate the SLA. See policy- CMP0133.- Note - This option was added in response to macOS 12.0's deprecation of the - hdiutil udifrezcommand to make its use optional. CPack 3.22 and below always use- CPACK_RESOURCE_FILE_LICENSE, if set to a non-default value, as the DMG license.
- CPACK_DMG_SLA_DIR¶
- Added in version 3.5. - Directory where license and menu files for different languages are stored. Setting this causes CPack to look for a - <language>.menu.txtand- <language>.license.txtor- <language>.license.rtffile for every language defined in- CPACK_DMG_SLA_LANGUAGES. If both this variable and- CPACK_RESOURCE_FILE_LICENSEare set, CPack will only look for the menu files and use the same license file for all languages. If both- <language>.license.txtand- <language>.license.rtfexist, the- .txtfile will be used.- Added in version 3.17: RTF support. 
- CPACK_DMG_SLA_LANGUAGES¶
- Added in version 3.5. - Languages for which a license agreement is provided when mounting the generated DMG. A menu file consists of 9 lines of text. The first line is is the name of the language itself, uppercase, in English (e.g. German). The other lines are translations of the following strings: - Agree 
- Disagree 
- Print 
- Save... 
- You agree to the terms of the License Agreement when you click the "Agree" button. 
- Software License Agreement 
- This text cannot be saved. The disk may be full or locked, or the file may be locked. 
- Unable to print. Make sure you have selected a printer. 
 - For every language in this list, CPack will try to find files - <language>.menu.txtand- <language>.license.txtin the directory specified by the- CPACK_DMG_SLA_DIRvariable.
- CPACK_DMG_<component>_FILE_NAME¶
- Added in version 3.17. - File name when packaging - <component>as its own DMG (- CPACK_COMPONENTS_GROUPINGset to- IGNORE).- Default:
- CPACK_PACKAGE_FILE_NAME-<component>
 
- CPACK_DMG_FILESYSTEM¶
- Added in version 3.21. - Default:
- HFS+
 - The filesystem format. Common values are - APFSand- HFS+. See- man hdiutilfor a full list of supported formats.
- CPACK_COMMAND_HDIUTIL¶
- Path to the - hdiutil(1)command used to operate on disk image files on macOS. This variable can be used to override the automatically detected command (or specify its location if the auto-detection fails to find it).
- CPACK_COMMAND_SETFILE¶
- Path to the - SetFile(1)command used to set extended attributes on files and directories on macOS. This variable can be used to override the automatically detected command (or specify its location if the auto-detection fails to find it).
- CPACK_COMMAND_REZ¶
- Path to the - Rez(1)command used to compile resources on macOS. This variable can be used to override the automatically detected command (or specify its location if the auto-detection fails to find it).
