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.

The Application page offers you a different set of options depending on the selected target platform:

Applications Options for Desktop Platforms

Applications Options.png

ApplicationOptionsOSX.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

DelphiPROJICON.png

cbuilder_PROJECTICON.ico

CbuilderPROJICON.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 OS X 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 OS X.

  • 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. OS X 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 OS X, follow the steps:

  1. Go to Project > Deployment to open the Deployment Manager.
  2. Select the build configuration for the OS X 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)

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.

Enable High-DPI

Specifies whether the application is DPI aware.

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.

Output Settings

Option Description

Target file extension

Specifies the extension of the final target file.

Application Options for iOS

ApplicationOptionsiOS.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_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 (ProjectOptionsEllipsis.jpg) 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 (87x87)
Application icon (114x114)
Application icon (120x120)
Application icon (180x180)
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)
Launch image (750x1334)
Launch image (1125x2436) - (iPhone X)
Launch image (2436x1125) - (iPhone X)
Launch image (1242x2208)
Launch image (2208x1242)
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 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.

Application Options for Android

ApplicationOptionsAndroid.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)

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 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\19.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.

Topics

See Also