cordova-assets

1.0.2 • Public • Published

cordova-assets

NPM package to generate assets, like icons and/or splashscreens, for Phonegap/Cordova applications based on a master file.

Installation

Requires ImageMagick and its tools to be installed. They can be found here: http://www.imagemagick.org/script/binary-releases.php

sudo npm install -g cordova-assets

Usage

**Currently only icons are supported.

Make sure that your input image for the icons is square in terms of dimensions. This makes it easier to scale. In addition, the input image should be bigger (ex: 500x500px) than any of the icon sizes since scaling down is generally better than scaling up. However, since you have fewer pixels to work with, it's inevitable that some of your detail is going to be lost. However, I'll will try and add sharpening to the images to try and minimize the loss.

Because of the awesome work of Ryan Parman (https://github.com/skyzyx/svg2png-cli) and Domenic Denicola (https://github.com/domenic/svg2png), whose code I have borrowed (OK, actually stolen), support for converting svg to png has been added.

    cga [options] input.png
options:
    -o         - Output directory. Default is current directory.
    -p         - comma delimited (no spaces) platforms to generate assets for.
                Current valid platforms are: ios android bb10 wp8 ff amazon.
                Default is all.
    -t         - Type of input image. Specify if file extension is not used for input image. Supported types are svg and png.
    			Default is png.                

Examples

cga -p ios icon.png

  • will generate all the icons for iOS using icon.png as the master file under a directory ./cga/ios/icons

cga -t svg icon

  • will generate all the icons for every supported platform using the svg input file icon as the master file

TO-DO

  • Add support for generating splashscreens
  • Add support for sharpening, changing DPI, ...
  • Optimize and clean up code

Package Sidebar

Install

npm i cordova-assets

Weekly Downloads

2

Version

1.0.2

License

MIT

Last publish

Collaborators

  • cesidio