Apple Disk Image (dmg)

Apple Disk Images are mountable filesystem volumes with the .dmg extension. On Mac OS X, they can be mounted with a double-click, and then installation of an application is as simple as a click-and-drag. This packager creates such an installer.

Warning

This packager has been known to fail at one of the final steps. Until this issue is fixed, simply retry the build.

Usage

packthing dmg

Requirements

This packager has no requirements.

Configuration

target:
    dmg:
        category:
        background:
        bundle:
category:

Provides the Launch Service application category, which categorizes the application for the Apple App Store.

category: public.app-category.developer-tools

Find your category here: LSApplicationCategoryType.

background:

Set the background image of the DMG volume. The path should be a relative path to an image in the master repository relative to the repository root.

background: icons/mac-dmg.png

The image must be 500 x 334. Support for custom sizing is planned.

bundle:

Specifies the executable whose icon should be used for the bundle icon.

bundle: propelleride

Example

target:
    dmg:
        category: public.app-category.developer-tools
        background: icons/mac-dmg.png
        bundle: propelleride