Application Options
Go Up to Project Options Dialog Box
Project > Options > Application
Contents
Use the Application page to set options for the current application.
Options | Description |
---|---|
Target, Apply, Save |
See Target Options. |
Common items |
The Application page offers you a different set of options depending on the selected target platform:
- Desktop Platforms (either VCL or FireMonkey)
- iOS (FireMonkey only)
- Android (FireMonkey only)
Applications Options for Desktop Platforms
For a multi-device application, the Application page lets you configure the following options.
Application Icon Settings
Option | Description | ||||
---|---|---|---|---|---|
Icon (for Windows applications) |
Specify an icon file (
RAD Studio provides personality-specific
For console applications, setting the application icon is disabled. Windows uses a standard console-mode icon by default. If you want to change the icon for your console application, see the following tutorial: Delphi @ About.com: Change the Default Application Icon for a Console Mode Delphi Application. | ||||
Icns icon (for FireMonkey OS X applications) |
Specify an Icns icon (
RAD Studio provides personality-specific
Each To refresh the icns icon file that you want to deploy to the OS X, follow the steps:
|
Manifest File (Windows Only)
Option | Description |
---|---|
Auto Generate |
Specifies whether the manifest file generates automatically. You can select one of the following options:
|
Enable Runtime Themes |
Specifies whether the application you are developing is to use run-time themes. |
Enable High-DPI |
Specifies whether the application is DPI aware. |
Enable Administrator Privileges |
Specifies whether the application requires administrator permissions. If you select this option, the application must run with administrator permissions. If you try to run the application with a user that does not have administrator permissions, the system prompts you for credentials.
|
Custom manifest |
If you select Custom, the Custom manifest field is enabled. Click the ellipsis button [...] to browse for the See Customizing the Windows Application Manifest File for more information and examples of custom Windows application manifest files. |
Output Settings
Option | Description |
---|---|
Target file extension |
Specifies the extension of the final target file. |
Application Options for iOS
For an iOS application, the Application page provides two tabs:
- iPhone
- iPad
Icons for Your iOS Apps
For the iPhone and iPad platforms, RAD Studio provides icon files that you can use for FireMonkey iOS applications in the form of .png
files of various sizes, available in the /bin/Artwork/iOS
directory of your product installation.
For example, here are the names of the some of the icon files provided by RAD Studio:
- FM_ApplicationIcon_57x57.png
- FM_LaunchImage_640x960.png
- FM_SettingIcon_29x29.png
- FM_SpotlightSearchicon_100x100.png
To configure the images and icons that are deployed along with your iOS application, click the ellipsis () in the appropriate field on the platform-specific tab (iPhone or iPad).
iPhone Tab
Field | Description |
---|---|
Application icon (57x57) | Icon representing your application. This is the icon that your users can place on their Home screen, and tap to start your application. |
Application icon (60x60) | |
Application icon (114x114) | |
Application icon (120x120) | |
Launch image (320x480) | Placeholder image for the first screen of your application.
The launch image is displayed instead of your application until your application finishes loading and takes the place of the image. |
Launch image (640x960) | |
Launch image (640x1136) | |
Spotlight search icon (29x29) | Icon representing your application on the settings pages and Spotlight search results. |
Spotlight search icon (40x40) | |
Spotlight search icon (58x58) | |
Spotlight search icon (80x80) |
iPad Tab
Field | Description |
---|---|
Application icon (72x72) | Icon representing your application. This is the icon that your users can place on their Home screen, and tap to start your application. |
Application icon (76x76) | |
Application icon (144x144) | |
Application icon (152x152) | |
Launch image (portrait, 768x1004) | Placeholder image for the first screen of your application.
The launch image is displayed instead of your application until your application finishes loading and takes the place of the image. |
Launch image (portrait, 768x1024) | |
Launch image (landscape, 1024x748) | |
Launch image (landscape, 1024x768) | |
Launch image (portrait, 1536x2008) | |
Launch image (portrait, 1536x2048) | |
Launch image (landscape, 2048x1496) | |
Launch image (landscape, 2048x1536) | |
Spotlight search icon (40x40) | Icon representing your application on the settings pages and Spotlight search results. |
Spotlight search icon (50x50) | |
Spotlight search icon (80x80) | |
Spotlight search icon (100x100) | |
Setting icon (29x29) | Icon representing your application on the settings pages and Spotlight search results. |
Setting icon (58x58) |
Preview
Option | Description |
---|---|
Preview |
For iOS target platforms, this field appears on the right-hand side of the Application page and displays a preview of the selected image. |
Actual size |
Check this checkbox to have the Preview show the icon in its actual size. By default, the preview is resized so that it does not take more space than is available in the right-hand column. Depending on the size of the image, you might need to scroll to see the whole image. |
Notes for iOS
- You can always configure the images and icons in the iPhone and iPad tabs, regardless of the target iOS device currently selected.
- Image files must be
.png
files, and the files must have the required dimensions; otherwise you get an error message.
- Not all images are required; for details, see the Apple Custom Icon and Image Creation Guidelines.
- If you do not want to provide a specific image, clear the image field, and click OK.
- If you clear an image field, make sure the selected Target on the Application page is All configurations. Empty fields are filled with the paths in parent targets, and All configurations is the only target that does not get overwritten.
- You can also define the
UIDeviceFamily
property value associated with your iOS app.UIDeviceFamily
is a value in the info.plist file associated with your iOS app;UIDeviceFamily
defines the iOS devices on which your app is supported. For iOS apps, the defaultUIDeviceFamily
is iPhone & iPad, but you can limit your iOS app to either iPad or iPhone if you prefer. SetUIDeviceFamily
in the Key/Value list on Project > Options > Version Info.
Application Options for Android
For an Android application, the Application page provides one tab:
Artwork for Your Android Apps
For the Android platform, RAD Studio provides icon files and splash images that you can use for FireMonkey Android applications in the form of .png
files of various sizes, available in the \bin\Artwork\Android
directory of your product installation.
To configure the icon files and splash images that are deployed along with your multi-device application, click the ellipsis () in the appropriate field on the Artwork tab.
Artwork Tab for Android
Launcher Icons
Field | Description |
---|---|
Launcher icon (36x36 ldpi) |
Icon representing your application. |
Launcher icon (48x48 mdpi) | |
Launcher icon (72x72 hdpi) | |
Launcher icon (96x96 xhdpi) | |
Launcher icon (144x144 xxhdpi) |
Splash Images
You can enable and disable the Splash Images of your project using the Include splash image checkbox.
Field | Description |
---|---|
Splash image (426x320 small) |
Splash images for your application. |
Splash image (470x320 normal) | |
Splash image (640x480 large) | |
Splash image (960x720 xlarge) |
Splash tile mode: When the tile mode is enabled, the image is repeated. Use this combo box to set the tile mode using the following options:
Tile mode | Description |
---|---|
disabled | The image appears once in the screen. |
clamp | The color at the edge of the image is replicated to fit the screen. |
repeat | The image is repeated horizontally and vertically to fit the screen. |
mirror | The image is repeated horizontally and vertically to fit the screen with a mirror effect on alternate images. |
See the Android Tile Mode documentation for more information.
Splash gravity: The splash gravity indicates the position of the image on the screen when the image is smaller than the screen. Splash gravity is taken into account only when Splash tile mode is disabled. See the Android Gravity documentation for more information.
Notes about Images for Android
- You can always configure your app images in the Artwork tab, regardless of the target mobile device currently selected.
- Image files must be *
.png
* files, and the files must have the required dimensions; otherwise you get an error message.
- Android allows using 9-patch images that determine how the image is stretched.
- You can convert an image to 9-patch using draw9patch tool available in
C:\Users\Public\Documents\Embarcadero\Studio\18.0\CatalogRepository\AndroidSDK-<Version>\tools\lib
. - When using the draw9patch tool, you can load
.png
and.9.png
images, once completed your image will be saved with.9.png
extension. Draw9patch works with one-pixel perimeter, so.png
images will be saved with 4 extra pixels (2 horizontally and 2 vertically),.9.png
images remain as they are. - Set the top and left one-pixel wide guides with solid black to determine the scalable area of the image. See the Android Draw 9-patch documentation for more information.
- You can convert an image to 9-patch using draw9patch tool available in
- All images are optional.
- If you do not want to provide a specific image, clear the image field, and click OK.
- If you clear an image field, make sure the selected Target on the Application page is All configurations. Empty fields are filled with the paths in parent targets, and All configurations is the only target that does not get overwritten.
- When you run an Android application on a Kindle Fire, the carousel shows the mdpi (48x48) launcher icon of your application, even if you provide an icon of higher resolution, and it looks blurry. However, this only happens when you install your Android application on your Kindle Fire through USB. When your users download your application from the Amazon application store, the icon of your application that the Kindle Fire displays on the carousel is downloaded from the Amazon application store itself, where you can upload a small application icon (114x114) and a large application icon (512x512). See the Amazon documentation for more information.
Topics
- Application Icns dialog box
- Application Icon dialog box
- Appearance page
- Orientation page