This tiny Java application generate all size of icon & launch image files with PNG format for various version of iOS.
Support iPhone, iPad and optionally supports Apple Watch, CarPlay, Mac.
To generate images, just drop original icon PNG file (1024 x 1024 pixels recommended) to the window and press "Generate" button.
Contents.json and scaled images going to be generated with appropriate filename.
For compatibility maintenance, iOS 6 icon can specify separately, but usually does not need to set for it.
Also icon and launch images especially for iPad can be specified. (If not set, same images as iPhone will be used.)
Optionally, Apple Watch, CarPlay and Mac icon could set separately, too.
These are not requirement. You should set these images only when you want to generate.
*Icon for Apple Watch generate as 24 bits RGB PNG, without alpha channel.
The launch images are also optional.
Square PNG file 2048 x 2048 pixels recommended.
The square shape is not a requirement, but it's easy way to generate universal launch images.
Each settings can be specified by using command line options. This means generating process can be automated by using command line options with no gui.
You can store settings to XML property file and load next time.
Individual command-line options are stronger than XML property file.
From Ver 2.0, last settings will be restored automatically at the next startup.
Settings stored to 'ios-image-util.properties' on window closing,
this means the last settings will not be restored when executing by jar file from other directories.
Extra feature, generating @3x, @2x, @1x images from one PNG file. (drop/select multiple files are supported.)
From Ver 2.0, Image Set with Size Class is supported.
With 'Generate with Image Set' option, Contents.json going to be generated with scaled images.
*This application will not support "Brand Assets". (In other words, Apple TV icons are not supported.) Also will not support "Memory" and "Graphics" properties for Image Set. These are available with Xcode 7 or later.
| Type | iOS Ver | Filename | Width | Height |
|---|---|---|---|---|
| Icon | ~6.x | Icon.png | 57 | 57 |
| ~6.x | Icon@2x.png | 114 | 114 | |
| Icon-Small.png | 29 | 29 | ||
| Icon-Small@2x.png | 58 | 58 | ||
| 8.x~ | Icon-Small@3x.png | 87 | 87 | |
| 7.x~ | Icon-Small-40.png | 40 | 40 | |
| 7.x~ | Icon-Small-40@2x.png | 80 | 80 | |
| 8.x~ | Icon-Small-40@3x.png | 120 | 120 | |
| ~6.x | Icon-Small-50.png | 50 | 50 | |
| ~6,x | Icon-Small-50@2x.png | 100 | 100 | |
| 7.x~ | Icon-60@2x.png | 120 | 120 | |
| 8.x~ | Icon-60@3x.png | 180 | 180 | |
| ~6.x | Icon-72.png | 72 | 72 | |
| ~6.x | Icon-72@2x.png | 144 | 144 | |
| 7.x~ | Icon-76.png | 76 | 76 | |
| 7.x~ | Icon-76@2x.png | 152 | 152 | |
| 9.x~ | Icon-83.5@2x.png | 167 | 167 | |
| 11.x~ | for marketing (ios, watch) | 1024 | 1024 | |
| (Notification | 7.x~ | 20x20.png | 20 | 20 |
| 7.x~ | 20x20@2x.png | 40 | 40 | |
| 7.x~ | 20x20@3x.png | 60 | 60 | |
| (Apple Watch) | 8.x~ | 24x24@2x.png | 48 | 48 |
| 8.x~ | 27.5x27.5@2x.png | 55 | 55 | |
| 8.x~ | 29x29@2x.png | 58 | 58 | |
| 8.x~ | 29x29@3x.png | 87 | 87 | |
| 8.x~ | 40x40@2x.png | 80 | 80 | |
| 8.x~ | 44x44@2x.png | 88 | 88 | |
| 8.x~ | 86x86@2x.png | 172 | 172 | |
| 8.x~ | 98x98@2x.png | 196 | 196 | |
| (CarPlay) | 8.x | 120x120@1x.png | 120 | 120 |
| 9.x~ | 60x60@2x.png | 120 | 120 | |
| 9.x~ | 60x60@3x.png | 180 | 180 | |
| Launch | ~6.x | Default.png | 320 | 480 |
| Default@2x.png | 640 | 960 | ||
| Default-568h@2x.png | 640 | 1136 | ||
| Default-667h@2x.png | 750 | 1334 | ||
| Default-736h@3x.png | 1242 | 2208 | ||
| 11.x~ | Default-812h@3x.png | 1125 | 2436 | |
| 11.x~ | Default-Landscape-812h@3x.png | 2436 | 1125 | |
| Default-1366h@2x.png | 2048 | 2732 | ||
| Default-Laundscape-736h@3x.png | 2208 | 1242 | ||
| Default-Portrait~ipad.png | 768 | 1024 | ||
| Default-Portrait@2x~ipad.png | 1536 | 2048 | ||
| Default-Landscape~ipad.png | 1024 | 768 | ||
| Default-Landscape@2x~ipad.png | 2048 | 1536 | ||
| (optional) | ~6.x | Default-Portrait.png | 768 | 1004 |
| ~6.x | Default-Portrait@2x.png | 1536 | 2008 | |
| ~6.x | Default-Landscape.png | 1024 | 748 | |
| ~6.x | Default-Landscape@2x.png | 2048 | 1496 | |
| (Apple TV) | 9.x~ | Default-Landscape-Tv.png | 1920 | 1080 |
| 11.x~ | Default-Landscape-Tv@2x.png | 3840 | 2160 | |
| Artwork | - | iTunesArtwork | 512 | 512 |
| - | iTunesArtwork@2x | 1024 | 1024 |
- JDK 1.6 or later
-
You can compile this code with pure JDK or Eclipse or Ant or Maven. (Any way you want, this code does not depend on any external libraries.)
-
Eclipse Java Development Tools (Any version maybe. This code does not depend on any external libraries.)
-
Ant (Any version maybe. I tested with 1.9.3. Move to the directory same as build.xml on your console and just type 'ant'.)
-
Maven (Any version maybe. I tested with 3.1.1. Move to the directory same as pom.xml on your console and just type 'mvn clean compile jar:jar'.)
-
java -jar ios-image-util.jar
or run with main-class.
-
java -classpath ios-image-util.jar org.gootara.ios.image.util.IOSImageUtil
-h, -help show this help message and exit
-b, -batch run as batch mode (no gui)
-v, -verbose verbose mode (available with batch mode only)
-silent no log (available with batch mode only)
-props property file location (full path)
-n, -new clear previous settings on startup (gui only)
-r, -reset force reset all properties (gui only)
-icon6 "icon png path" iOS 6 icon png file location (full path)
-watch "icon png path" Apple Watch icon png file location (full path)
-carplay "icon png path" CarPlay icon png file location (full path)
-mac "icon png path" Mac icon png file loaction (full path)
-iconipad "icon png path" iPad icon png file loaction (full path)
-icon7 "icon png path" iOS 7 icon png file loaction (full path)
-launch "launch image path" launch image png file location (full path)
-launchipad "image path" iPad launch image png file location (full path)
-output "output directory" output directory location (full path)
-iphoneonly output iPhone images only (default both)
-ipadonly output iPad images only (default both)
-to-status-bar generate 'to-status-bar' launch images
-noasset not generate images as asset catalogs
-noartwork not generate ArtWork images for Store
-noprerender not generate as pre-rendered
-noclean not clean target files before generate
-minver [0,7,8] minimum version to generate (default: 0)
0: All versions
7: iOS 7 and Later
8: iOS 8 and Later
-lscale [0-5] launch image scaling (default: 4)
0: no resizing (iPhone only)
1: no resizing (iPhone & iPad)
2: fit to screen height (iPhone only)
3: fit to screen
4: fill screen (prefer long side)
5: fill screen (no aspect ratio)
-lbgcolor [RGB|ARGB] '000000' black, '00FFFFFF' white 100% transparent
-imagetype [0-13] choose image type (@see BufferedImage)
For Image Set:
-sp3x deprecated. Use '-spSize 100%:100%' instead
-spSize width:height generate @3x, @2x, @1x with @1x(px)|@3x(%) size
-spNoReplace not overwrite if file already exists
-spNoClean not clean target files before generate
-spBgcolor background color.
-spScaling scaling type (default: 3)
0: no resizing
1: fit to short side
2: fit to long side
3: fit with aspect ratio
4: fill without aspect ratio
-spDir "path" Output directory. (relative or absolute)
-spFile "png path" image sets png file location (full path)
multiple files available. (Separate by system path separator)
-spFile option is available with batch mode only.
2014/01/15
- Change output filenames suitable for the xcode 5.
- "Generate old size of Splash images for iPad" checkbox was added.(optional)
2014/01/29
- Add new output option. iPhone only, iPad only or both.
- "Fit iPhone's Splash images to the screen" checkbox was added.
- Change optional output filenames.
2014/02/01
- Add two splash scaling options. (No resizing)
2014/02/14
- Add build.xml for Ant and pom.xml for Maven.
2014/02/22
- Supports output with "Asset Catalogs" format.
- Change word: "Splash" -> "Launch"
2014/02/24
- Supports command line options. Each setting can be specified by using command line options with gui. Also the generate process can be automated by using command line options with no gui.
2014/02/26
- Refactoring and performance improvement.
- Add launch image scaling option 'fill screen (prefer long side)' and 'fill screen (no aspect ratio)'.
2014/03/08
- Add launch image background color option.
- Add output image type option.
- Update documents.
2014/09/11
- Supports iPhone 6 and iPhone 6 Plus.
- Apple will no longer supports Launch Images in the near future, maybe.
2014/09/23
- Supports Launch Image Retina HD 4.7 and Retina HD 5.5 (both portrait and landscape)
2014/09/28
- Simplified User Interface. Just add a surface, but it looks little bit modern, isn't it? :p
- To use SwingWorker thread with generating images.
2014/10/05
- Fix problem when maximized.
- Fix build.xml for ant.
- Add image splitter. Generate @3x, @2x, @1x images from one png file.
2014/11/13
- Fix readme.
- Set maximum thumbnail size.
- Add out of memory error message.
2015/03/28
- Clear images by click.
- Refresh images when edit path text directly.
2015/04/29
- Supports Apple Watch and CarPlay icons.
- Choose icon images by pane clicking.
- Add "Do not generate ArtWork" option.
- Add some tooltips.
- Use anti-aliasing font on Windows platform in Japanese by default. (Coz default Japanese font is awful.)
- Some bug fixed.
2015/06/03
- To generate images by parallel processing.
- Supports to specify output subdirectory with the image set generator.
- Supports to drop multiple files to the image set generator. (gui mode only)
- Enable drag & drop on linux.
2015/06/07
- The XML property file is supported. (Other command-line options are stronger than property file)
- Supports to choose multiple files to the image set generator. (batch mode also)
- Apply same fix with the parallel processing.
- Add menu bar.
2015/07/19 - Version 2.0.0.0
- Supports Image Sets with Size Class.
- Restore last settings at the next startup.
- Update checker is implemented. (very easy one)
- And more.
2015/09/10 - 2.7.1.0
- Support part of Xcode 7.1 beta.
- Support Apple TV launch image. (Launch image only, not support icons)
- Support new CarPlay Icons (60x60x2, 60x60x3)
- Bug fix.
- This application will not support "Brand Assets".
2015/09/19 - 2.7.1.1
- Fix abnormal focus problem with dropping files on mac.
2016/01/24 - 2.7.2.0
- Support iPad Pro icon.
2016/01/24 - 2.7.2.1
- Selected scaling algorithm and image type applies to preview.
- Support to open output directory by selecting menu item or clicking label.
- Fix some bugs.
2016/02/04 - 2.7.2.2
- Add png sufix to iTunesArtwork images and force no alpha channel.
2016/09/22 - 2.8.0.0
- Add Notification Icons and 1366h Launch Image (for Xcode 8.0)
2016/10/11 - 2.8.1,0
- Splitter supports jpeg output.
2017/09/17 - 2.9.0.0
- Provisional support to iOS 11.