Creating and Deploying App Icons
Go Up to Developing Multi-Device Applications
Having a great-looking application icon is a must-have to increase your chance of success in the application stores. Your app icon represents your app in the application stores as well as on the target platform. This page explains how to configure the icons of your application using RAD Studio.
Contents
Default Icons
Some platforms do not allow running applications that do not provide application icons. RAD Studio provides default application icons, so that you can test your application on any platform even if you do not have icons for your application yet. However, before you publish your application you must replace the default RAD Studio icons with custom icons for your application. The following sections explain how to configure your application to use your custom icons.
The table below shows the paths where you can find the RAD Studio default icons, relative to the RAD Studio installation path: C:\Program Files (x86)\Embarcadero\Studio\23.0
. If you want all your new projects to use your own icons, replace these default icon files with your own files.
Required Icon Sizes
When you deploy your application, you must provide your application icon in different resolutions. The icon resolutions that you need depend on the target platform. Platforms may show your application icon in different contexts, such as an application launcher or a settings window. Depending on the context where your application icon is displayed, a different icon size may be required.
You should design different versions of your icon to support each of the resolutions that each one of your target platforms supports. Using a single icon and resizing your icon to fit each resolution is seldom a good idea. Even vector images require some adjustments on specific resolutions to look good in all resolutions.
The table below shows icon resolutions that the Windows and macOS platforms use. Each value under Icon resolutions in the table stands for the number of pixels per side of an icon. For example, 16 stands for an icon resolution of 16×16 pixels.
For iOS and Android resolutions, check the Application Options page.
- Note: Some platforms do not allow running applications that do not provide certain resolutions of application icons.
For example, macOS applications must include 512×512 icons to be accepted in the Apple App Store.
Platform | Icon resolutions | ||||||
---|---|---|---|---|---|---|---|
16 | 32 | 48 | 128 | 256 | 512 | 1024 | |
Windows |
|||||||
macOS |
|||||||
iOS |
See icons for iOS apps in Application Options. | ||||||
Android |
See icons for Android apps in Application Options. |
Note: An easy way to create multiple resolutions of your icons is to use the MultiResBitmap Editor, available in the IDE.
For more information, see Using Multi-Resolution Bitmaps.
Storing Your Icon Files into an Icon Container
Once you have your app icon in all the resolutions that a target platform requires, for desktop platforms you must then archive the different resolutions of your icon into a single file, an icon container, that you can deploy along with your application.
For Windows, you must create an .ico
icon container file. See How to make/get a multi size .ico file?.
For macOS, you must create an .icns
icon container file. See Use iconutil to Create an icns File Manually. Alternatively, you can use the RAD Studio ico2icns command-line tool to convert an existing .ico
file into an .icns
file.
On mobile platforms you do not need to provide an icon container file, you provide your application icons separately instead.
Configuring Your App Icons
Once you have your application icon files, select Project > Options > Application and provide the local paths of your icon files for each target platform. See Application Options for more information.
- Note: If you do not specify an
.icns
file, required for macOS, but you do specify an.ico
file, RAD Studio converts your.ico
file into an.icns
file and uses the resulting.icns
file when you deploy your application for macOS.
Troubleshooting
Cannot Add a 1024×1024 Icon into an macOS Icon Container
In order to include an application icon with a resolution of 1024×1024 pixels into an .icns
file, you must be running macOS Lion or a later version of macOS.
Cannot Define an App Icon for My Command-Line Application
For command-line applications, setting the application icon is disabled. Platforms which support command-line applications use a standard console-mode icon by default.