Application Options

From RAD Studio
Jump to: navigation, search

Go Up to Project Options Dialog Box


Project > Options > Application

Use the Application page to set options for the current application.

Options Description

Target, Apply, Save

See Target Options.

Common items

See Common Items on Project Options Pages.

Output Settings

Option Description

Target file extension

Specifies the extension of the final target file.


The Application options vary depending on the selected target platform:

Applications Options for Desktop Platforms

Icons Windows.png

Icons MacOs.png

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 (.ico) to be inserted into the output file. The application icon that is displayed on this dialog box is displayed in Windows Explorer, next to the output file name.

  • Click Load Icon... to display the Application Icon dialog box and browse for an .ico file.
  • Click Default to restore the original default icon provided for your application.

RAD Studio provides personality-specific .ico files, which are available in the /bin directory of your product installation. Each .ico file contains a set of icons of various sizes. On Windows platforms, the appropriate size is automatically selected for each situation.

delphi_PROJECTICON.ico

object_pascal_PROJECTICON.ico

Delphi PROJECTICON.png

cbuilder_PROJECTICON.ico

Cbuilder PROJECTICON.png

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 macOS applications)

Specify an Icns icon (.icns) file to be inserted into the output file. The icon that is displayed on this dialog box is used to represent your application on macOS.

  • Click Load Icns... to display the Application Icns dialog box and browse for an .icns file.
  • Click Default to restore the original default icon provided for your RAD Studio application.

RAD Studio provides personality-specific .icns files, which are available in the /bin directory of your product installation. The file names are:

  • object_pascalPROJECTICNS.icns
  • delphi_PROJECTICNS.icns
  • cbuilder_PROJECTICNS.icns

Each .icns file contains a set of icons of various sizes. macOS selects the appropriate size automatically for each situation. For information about creating a valid Icns icon for your application, see:

To refresh the icns icon file that you want to deploy to the macOS, follow the steps:

  1. Go to Project > Deployment to open the Deployment Manager.
  2. Select the build configuration for the macOS project from the Configuration Selector combo box.
  3. Click Revert to Default to add the new icns icon file to the Deployment Manager. Revert to Default removes all the entries that are not required any more, such as the previous icns icon file.

Manifest File (Windows Only)

Manifest.png

Option Description

Auto Generate

Specifies whether the manifest file generates automatically. You can select one of the following options:

  • None: The manifest file does not generate.
  • Auto Generate: The manifest file auto generates according to the below settings.
  • Custom: Use this option if you are going to provide a custom manifest. Use the field Custom manifest to indicate the .manifest file.

Enable Runtime Themes

Specifies whether the application you are developing is to use run-time themes.

Note: This option is enabled by default.

DPI Awareness

You can select the following options:

  • None: There is no DPI awareness.
  • Unaware: Choose this option when apps are rendered assuming 100% Scaling (96 DPI).
  • System Aware: Use this option when you know the app DPI of the main display at the time you log in to your computer.
  • Per Monitor: Select this option when apps are rendering content at different DPIs and can change the DPI scaling on the fly as the applications are moved between monitors with different DPIs.
  • Per Monitor v2: Use this option to receive a notification when the application DPI changes.
  • GDI Scaling: Choose this option to render graphics and text to the correct scale regardless of which display it is displayed on.

Execution Level

Specifies the execution level for your application.

  • As Invoker: select this option to run your application with the same access token as the parent process. Use this option for standard user applications.
Refactor the app with internal elevation points.
  • Highest Available: select this option to run your application with the highest privileges the user can obtain. Use this option for mixed-mode applications.
Refactor the application in a future release.
  • Require Administrator: select this option for your application to require administrator permissions. The application runs only for administrators and requires that the application is launched with the full access token of an administrator.
Use it for administrator-only applications. Internal elevation points are not required, the application is already running elevated.

For more information on which option suits your application best, see Requested Execution Levels on Windows Dev Center.

Select UI Access if you want your application to bypass the user interface protection levels and drive input to higher-permission windows on the desktop.

Custom manifest

If you select Custom, the Custom manifest field is enabled. Click the ellipsis button [...] to browse for the .manifest file.

See Customizing the Windows Application Manifest File for more information and examples of custom Windows application manifest files.

Application Options for iOS

Ios device64 icons.png

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_120x120.png
  • FM_SpotlightSearchIcon_120x120.png
  • FM_SettingIcon_58x58.png
  • FM_NotificationIcon_40x40.png
  • FM_LaunchImage_2x.png

To configure the images and icons that are deployed along with your iOS application, click the ellipsis (ProjectOptionsEllipsis.jpg) in the appropriate field on the platform-specific tab (iPhone or iPad).

iPhone Tab

Field Description
Application icon (120x120) 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 (180x180)
Application icon (1024x1024) Icon representing your application on the App Store.
Spotlight icon (80x80) Icon representing your application on a Spotlight search.
Spotlight icon (120x120)
Settings icon (58x58) Icon representing your application on the built-in Settings application.
Settings icon (87x87)
Notification icon (40x40) The notification icon is displayed for the notifications of your application.
Notification icon (60x60)
Launch image Any appearance 2x scale The launch image is displayed instead of your application until your application finishes loading and takes the place of the image.
Launch image Dark appearance 2x scale
Launch image Any appearance 3x scale
Launch image Dark appearance 3x scale


iPad Tab

Field Description
Application icon (152x152) 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 (167x167)
Spotlight icon (80x80) Icon representing your application on a Spotlight search.
Settings icon (58x58) Icon representing your application on the built-in Settings application.
Notification icon (40x40) The notification icon is displayed for the notifications of your application.
Launch image Any appearance 2x scale

The launch image is displayed instead of your application until your application finishes loading and takes the place of the image.

Launch image Dark appearance 2x scale


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 default UIDeviceFamily is iPhone & iPad, but you can limit your iOS app to either iPad or iPhone if you prefer. Set UIDeviceFamily in the Key/Value list on Project > Options > Version Info.
  • iOS applications can be designed to support either Any or Dark appearance mode or both appearance modes at the same time.
Light appearance Dark appearance
The launch screen's background color and launch screen's image for the 'Any' appearance mode are used in an iOS application when the target device:
  • Runs on any iOS version
  • Has the system-wide appearance set to Light.
The launch screen's background color and image for the Dark appearance mode are used in an iOS application when the target device:
  • Runs an iOS version equal to or newer than 13.0
  • Has the system-wide appearance set as Dark.
  • The Launch image background color and Launch image dark background color options are available only under the iPhone tab, but they are applicable to both iPhone and iPad devices.
  • The support for the Dark appearance mode in an iOS application is optional. If an iOS application does not need to support the Dark appearance mode at this time, it is possible to clear the Launch image dark appearance 2x scale and Launch image dark appearance 3x scale options.

Application Options for Android

Android64 icons.png

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 (ProjectOptionsEllipsis.jpg) in the appropriate field on the Artwork tab.

Artwork Tab for Android

Launcher Icons

Field Description
Launcher icon (36x36 ldpi)

Icon representing your application.
(This is the icon that your users can place on their Home screen, and tap to start your application.)

Launcher icon (48x48 mdpi)
Launcher icon (72x72 hdpi)
Launcher icon (96x96 xhdpi)
Launcher icon (144x144 xxhdpi)

Notification Icons

Field Description
Notification icon (24x24 mdpi)

Notification icons for your application.
(These are the icons that your users can use for notifications.)

Notification icon (36x36 hdpi)
Notification icon (48x48 xhdpi)
Notification icon (72x72 xxhdpi)
Notification icon (96x96 xxxhdpi)

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.
(These are the images that will be displayed while your application is opening. You can specify either a single image or several different-sized images. To minimize rescaling, use either one multi-res bitmap or several different-sized images.)

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 on 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\22.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.
  • 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.
  • To deploy an Android application without a splash screen, before disabling the Include splash image option and re-building the application, first is necessary to manually delete the splash_image_def.xml, styles.xml and styles-v21.xml files that were created for a previous build of your application (these files are supposed to be inside the '<Active-Target-Platform>\<Active-Build-Configuration>' sub-folder).

Topics

See Also