Grunt plugin for generating Mac OS X DMG-images.
npm install grunt-appdmg[![NPM Version][npm-image]][npm-url]
[![Build Status][travis-image]][travis-url]
[![Dependency Status][deps-image]][deps-url]
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.
This plugin requires Grunt >=0.4.0.
If you haven't used Grunt before, be sure to check out the Getting started guide.
sh
$ npm install grunt-appdmg --save-dev
`Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
`js
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
$3
See the appdmg specification.
Additionally basepath option is available in this plugin.#### basepath
Type:
String
Default: process.cwd() - directory that contains Gruntfile.jsOptional. Base path to look for asset files:
icon, background and contents.path.$3
In your project's Gruntfile, add a section named appdmg to the data object passed into grunt.initConfig().`js
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'
}
}
});
``[npm-image]: https://img.shields.io/npm/v/grunt-appdmg.svg
[npm-url]: https://www.npmjs.com/package/grunt-appdmg
[travis-image]: https://travis-ci.org/rakuten-frontend/grunt-appdmg.svg?branch=master
[travis-url]: https://travis-ci.org/rakuten-frontend/grunt-appdmg
[deps-image]: https://david-dm.org/rakuten-frontend/grunt-appdmg.svg
[deps-url]: https://david-dm.org/rakuten-frontend/grunt-appdmg