Git Product home page Git Product logo

electron-installer-dmg's Introduction

electron-installer-dmg travis npm

Create DMG installers for your electron apps using appdmg.

Installation

# For use in npm scripts
npm i electron-installer-dmg --save-dev

# For use from cli
npm i electron-installer-dmg -g

Usage

Usage: electron-installer-dmg <path/to/.app> <appname>

Create DMG installers for your electron apps.

Usage:
  electron-installer-dmg ./FooBar-darwin-x64/FooBar.app FooBar

Options:
  --out=<path>         The directory to put the DMG into. [Default: `process.cwd()`].
  --icon=<path>        Path to the icon file that will be the app icon in the DMG window.
  --icon-size=<px>     How big to make the icon for the app in the DMG. [Default: `80`].
  --background=<path>  Path to a PNG image to use as the background of the DMG. [Size: 658 x 498]
  --debug              Enable debug messages.
  --overwrite          Overwrite any existing DMG.
  -h --help            Show this screen.
  --version            Show version.

API

var createDMG = require('electron-installer-dmg')
createDMG(opts, function done (err) { })

createDMG(opts, callback)

opts

Required appPath - String The .app directory generated by electron-packager.

name - String The application name.

Optional

background - String Path to the background for the DMG window. Background image should be of size 658 × 498.

icon - String Path to the icon to use for the app in the DMG window.

overwrite - Boolean Overwrite an existing DMG file if if already exists.

debug - Boolean Enable debug message output.

out - String The directory to put the DMG into. [Default: process.cwd()].

icon-size - Number How big to make the icon for the app in the DMG. [Default: 80].

contents - Array or Function that returns an Array of objects. The content that will appear in the window when user opens the .dmg file. [Default: Array of two icons, application and application destination folder]. Array Example:

[ { x: 448, y: 344, type: 'link', path: '/Applications'},
  { x: 192, y: 344, type: 'file', path: '/path/to/application.app'} ]

Function Example (more flexible for getting useful options used in creating dmg):

function (opts) {
   return [ { x: 448, y: 344, type: 'link', path: '/Applications'},
            { x: 192, y: 344, type: 'file', path: opts.appPath} ];
}

format - String Disk image format. [Default: UDZO].

Must be one of the following:

  • UDRW ➡️ read/write image
  • UDRO ➡️ read-only image
  • UDCO ➡️ ADC-compressed image
  • UDZO ➡️ zlib-compressed image
  • UDBZ ➡️ bzip2-compressed image
  • ULFO ➡️ lzfse-compressed image (macOS 10.11+ only)
callback

err - Error Contains errors if any.

License

Apache 2.0

electron-installer-dmg's People

Contributors

imlucas avatar mnaamani avatar pzrq avatar alexanderturinske avatar jupjohn avatar kangas avatar carlos121493 avatar greenkeeper[bot] avatar

Watchers

James Cloos avatar Tarun K. Singhal avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.