splicon
v0.0.15
Published
Generate cordova/splash files from a single svg, and update config.xml
Downloads
663
Readme
Splicon (beta)
Splicon is a command-line tool and library for generating icons and splash screens for Cordova projects. It generates the images for each platform's required sizes using a single source SVG and updates the project's config.xml.
It was originally built for use in ember-cordova.
It is built for Node 0.12+ but may work on earlier versions.
Icons
For an integration example, see the ember-cordova make-icon
command.
Using the CLI, from your Cordova project, run:
splicon-icons
This command will:
- Look for a file called 'icon.svg';
- Resize the SVG for each required platform/icon combination;
- Move the icons to res/icons/platformName (and create the dir if it does not exist);
- Update your config.xml to represent the new icons & paths;
- Ensure there are no duplicate icon nodes in config.xml;
By default, images for all platforms will be generated. To generate images for specific platforms you can pass the platforms as arguments:
splicon-icons ios android windows
For more granular control (such as setting the destination path), you will need to require src/icon-task and run the function yourself.
There is a TODO to enhance CLI flag, but in most cases this is handled in ember-cordova.
Splash Screens
splicon-splashes
Like splicon-icons
, by default images for all platforms will be generated. To
generate images for specific platforms you can pass the platforms as arguments:
splicon-splashes ios
Testing
npm test
Contributing
PRs are very welcome. You can read our style guides here.
If you are unsure about your contribution idea, please feel free to open an issue for feedback.
Credits
ember-cordova is maintained by Isle of Code and was written by Alex Blom and Jordan Yee based on work by Chris Thoburn and Alex Blom.