What’s the first thing users see when they download your app? What about after they install it and start the app?
An app icon and splash screen (launch image) are important parts of any app, yet making them used to be incredibly tedious. You needed numerous icons for iOS and Android, and then you had to deal with splash screens and all their different sizes. To save you the stress of dealing with all that, we’ve made it possible for you to generate app icons and splash screens via the Ionic CLI.
Generate those Resources
With the new CLI, all you need is a resource directory and two images. These images can be
.png files, Photoshop
.psd files, or Illustrator
.ai files, named icon.png (for example) and splash.png. With the images in a resources directory,
ionic resources command will generate the icons and splash screen images for each platform setup in the project, sending them to Ionic’s image resizing and cropping server, so you don’t have to install extra dependencies.
$ ionic resources
After the images are generated, the CLI will update the
config.xml to include the icons and splash screens, so they will be transferred over in Cordova’s build process. NOTE: This process requires Cordova CLI version 3.6 or higher.
If you only need to update one of the resources, or you only want to generate icons and not both, the
ionic resources command has two flags that allow you to target each asset, instead of generating both.
$ ionic resources --icon $ ionic resources --splash
In order to be able to crop and resize images to fit the various needs of each platform, icons and splash screen images should meet a minimum size requirement
The icon image’s minimum dimensions should be 192×192 px and should have no rounded corners. Note that each platform will apply its own mask and effects to the icons. For example, iOS will automatically apply its custom rounded corners, so the source file should not already come with rounded corners.
Splash screen dimensions vary for each platform, device, and orientation, so a square source image is required to generate each of the various screen sizes. The source image’s minimum dimensions should be 2208×2208 px, and the artwork should be centered within the square, because each generated image will be center cropped into landscape and portrait images.
The splash screen’s artwork should roughly fit within a center square (1200×1200 px). This template provides the recommended size and guidelines about artwork’s safe zone.
Want different icons for the iOS and Android versions of your app? No problem; we’ve got that covered, too. To use different source images for individual platforms, place the source image in the respective platform’s directory. To use a different icon for Android, the image should follow this path:
resources/android/icon.png, and the image for iOS should use this path:
resources/ios/icon.png. This way, you can have an iOS icon with native rounded corners and an Android icon with a transparent background.
This is just one more way Ionic aims to make developers’ lives easier, not to mention more fun. Update your CLI and try out the resource generator today.
$ npm install -g ionic
As we mentioned in our Beta 14 blog post, we’ve been working on adding Crosswalk integration for Android into our CLI. Josh has been hard at work on this, and it will be landing in the CLI as a beta feature soon. Keep an eye on the CLI!