cordova-icon-and-splash

Automatic icon and splash page creation for Cordova apps.

Create an icon.png and splash.png in the root folder of your Cordova project and use cordova-icon-and-splash to automatically create all the needed image assets for your iOS and Android project.

---

Adapted from 'cordov-icon' by AlexDisler but updated to do both icon and splash and also up to date with 2020 phones.

by CoCreations

---

Installation

$ sudo apt-get install imagemagick
$ # on Mac: brew install imagemagick 
$ # on Windows: http://www.imagemagick.org/script/binary-releases.php#windows (check "Legacy tools") 
 
$ sudo npm install cordova-icon-and-splash -g

Requirements

• ImageMagick installed
• At least one platform was added to your project (cordova platforms docs)
• Cordova's config.xml file must exist in the root folder (cordova config.xml docs)

Usage

Create an icon.png file in the root folder of your cordova project.

Also create a splash.png file.

You can provide a platform-specific icon by naming it icon-[platform].png (e.g icon-android.png, icon-ios.png). Then run:

 $ cordova-icon-and-splash

You also can specify manually a location for your config.xml or icon.png, or 'splash.png':

 $ cordova-icon-and-splash --config=config.xml --icon=icon.png --splash=splash.png

If you run a old version of Cordova for iOS / Mac and you need your files in /Resources/icons/, use this option:

 $ cordova-icon-and-splash --xcode-old

For good results, your Icon file should be:

• square
• 1024*1024

And your Splash file can be a little bigger.

Notes:

• Your config.ml file will not be updated by the tool (because images are automatically created in the good folders)
• Therefore, in your config.xml, be sure to remove all lines looking like <icon src="res/android/ldpi.png" density="ldpi" />

Creating a cordova-cli hook

Since the execution of cordova-icon is pretty fast, you can add it as a cordova-cli hook to execute before every build. To create a new hook, go to your cordova project and run:

$ mkdir hooks/after_prepare
$ vi hooks/after_prepare/cordova-icon.sh

Paste the following into the hook script:

#!/bin/bash
cordova-icon-and-splash

Then give the script +x permission:

$ chmod +x hooks/after_prepare/cordova-icon.sh

That's it. Now every time you cordova build, the icons will be auto generated.

Splash screens

Check out cordova-splash

More

• cordova-plugin-inapppurchase - a lightweight cordova plugin for in app purchases on iOS/Android
• ng-special-offer - prompt users to rate your cordova app in the app store
• ionic-lock-screen - passcode lock screen for ionic (with touch id support for iOS)
• ionic-zoom-view - an easy way to add a zoom view to images using an ionic modal
• ng-persist - store data on mobile devices (using cordova) that persists even if the user reinstalls the app

License

MIT