Application Options

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 type of application you are developing:

• Desktop application options (either VCL or FireMonkey)
• Mobile application options (FireMonkey only)

Desktop Application Options

For a desktop application, the Application page lets you configure the following options:

Option	Description
	Application Icon Settings
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's 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 and /bin64 directories 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 cbuilder_PROJECTICON.ico 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 Mac 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 a Mac. 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 and /bin64 directories of your product installation. The file names are: 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. See Mac OS X Application Development.
	Run-time Themes
Enable runtime themes	Specifies whether the application you are developing is to use run-time themes or to use a custom manifest. By default, this field is None for preexisting projects and Enable runtime themes for new projects. None means that the application does not use theming or a manifest file. Enable runtime themes means that the application uses themes. Use custom manifest means that you supply a custom .manifest file for the application to use.
Custom manifest	If you select Use custom manifest, the Custom manifest field is enabled. To browse for .manifest files, click the ellipsis button [...].
	Output Settings
Target file extension	Specifies the extension of the final target file.

	Preview Options
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.

FireMonkey Mobile Application Options

For a mobile application, the Application page provides three tabs:

• iPhone
• iPad
• Orientation

Icons for Your Mobile 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 and /bin64 directories 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 mobile 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 114x114
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 58x58

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 144x144
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 landscape 1024x748
Launch image portrait 1536x2008
Launch image landscape 2048x1496
Spotlight search icon 50x50	Icon representing your application on the settings pages and Spotlight search results.
Spotlight search icon 100x100
Setting icon 29x29	Icon representing your application on the settings pages and Spotlight search results.
Setting icon 58x58

Orientation Tab

Field

Description

Custom orientation

Check this checkbox so that you can limit or specify the orientations that your iOS app supports. For example, to always display your iOS app in portrait orientation, check the Custom orientation and Portrait checkboxes. iOS devices support rotation of the form in the following directions: iPad: Rotates in all directions iPhone and iPod Touch: Rotates in all directions except upside down If Custom orientation is not checked, then the orientation of your app responds to the default rotations, according to the iOS device. Portrait iOS app displays in a vertical (portrait) orientation. Upside down iOS app displays in a vertical orientation, but upside down, with the device's Home button on the top instead of on the bottom. Landscape home right iOS app displays in a horizontal (landscape) orientation with the device's Home button on the right. Landscape home left iOS app displays in a horizontal (landscape) orientation with the device's Home button on the left.

Notes

• You can always configure the images and icons in the iPhone and iPad tabs, 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.

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

See Also

• Application Appearance
• Application Help File
• Enabling Help in Applications
• Application Icon
• Icons for Your OS X Applications