grunt-appdmg

Grunt plugin for generating Mac OS X DMG-images.

Showing:

Popularity

Downloads/wk

6

GitHub Stars

15

Maintenance

Last Commit

5yrs ago

Contributors

3

Package

Dependencies

3

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

grunt-appdmg

Grunt plugin for generating Mac OS X DMG-images.

NPM Version Build Status Dependency Status

Overview

node-appdmg is an awesome command line tool that can generate beautiful disk images (.dmg) for your OS X applications. This Grunt plugin executes it programmatically using Gruntfile.

You can use Grunt template strings in the appdmg config, like: title: '<%= pkg.name %>'.

Note:
Currently grunt-appdmg works on Mac OS X only due to the node-appdmg limitation.

Getting started

This plugin requires Grunt >=0.4.0.
If you haven't used Grunt before, be sure to check out the Getting started guide.

Install

$ npm install grunt-appdmg --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-appdmg');

For cross platform projects:
If you want to include this plugin in a cross platform project, install grunt-appdmg with --save-optional flag instead of --save-dev. This will prevent npm-install error on Windows/Linux.

The "appdmg" task

Options

See the appdmg specification.
Additionally basepath option is available in this plugin.

basepath

Type: String
Default: process.cwd() - directory that contains Gruntfile.js

Optional. Base path to look for asset files: icon, background and contents.path.

Example

In your project's Gruntfile, add a section named appdmg to the data object passed into grunt.initConfig().

grunt.initConfig({
  appdmg: {
    options: {
      basepath: 'path/to/assets',
      title: 'Title of DMG',
      icon: 'icon.icns',
      background: 'background.png',
      contents: [
        {x: 448, y: 344, type: 'link', path: '/Applications'},
        {x: 192, y: 344, type: 'file', path: 'your-app.app'},
        {x: 512, y: 128, type: 'file', path: 'extra-file.txt'}
      ]
    },
    target: {
      dest: 'path/to/your-app.dmg'
    }
  }
});

License

Copyright (c) 2014-2017 Rakuten, Inc. Licensed under the MIT License.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial