github.com/goreleaser/goreleaser@v1.25.1/www/docs/customization/dmg.md (about)

     1  # DMG
     2  
     3  > Since: v1.24 pro
     4  
     5  !!! success "GoReleaser Pro"
     6  
     7      The dmg feature is available only in [GoReleaser Pro feature](/pro/).
     8  
     9  GoReleaser can create DMG images for macOS using `mkisofs` or `hdiutil`.
    10  
    11  The `dmg` section specifies how the images should be created:
    12  
    13  ```yaml
    14  # .goreleaser.yaml
    15  dmg:
    16    - # ID of the resulting image.
    17      #
    18      # Default: the project name
    19      id: foo
    20  
    21      # Filename of the image (without the extension).
    22      #
    23      # Default: '{{.ProjectName}}_{{.Arch}}'
    24      # Templates: allowed
    25      name: "myproject-{{.Arch}}"
    26  
    27      # IDs of the archives to use.
    28      # Empty means all IDs.
    29      ids:
    30        - foo
    31        - bar
    32  
    33      # GOAMD64 to specify which amd64 version to use if there are multiple
    34      # versions from the build section.
    35      #
    36      # Default: v1
    37      goamd64: v1
    38  
    39      # More files that will be available in the context in which the image
    40      # will be built.
    41      extra_files:
    42        - logo.ico
    43  
    44      # Whether to remove the archives from the artifact list.
    45      # If left as false, your end release will have both the archives and the
    46      # dmg files.
    47      replace: true
    48  
    49      # Set the modified timestamp on the output image, typically
    50      # you would do this to ensure a build was reproducible. Pass an
    51      # empty string to skip modifying the output.
    52      #
    53      # Templates: allowed.
    54      mod_timestamp: "{{ .CommitTimestamp }}"
    55  ```
    56  
    57  ## Limitations
    58  
    59  1. Due to the way symbolic links are handled on Windows, the `/Applications`
    60     link inside the image might not work if the image was built on Windows.
    61  1. If running outside macOS, make sure to have `mkisofs` installed.
    62  
    63  !!! tip
    64  
    65      Learn more about the [name template engine](/customization/templates/).