Form Factor Settings in RAD Studio

From RAD Studio
Jump to: navigation, search

Go Up to Creating an iOS App


The following table summarizes the RAD Studio settings that determine the form factor used by your iOS application. When you create an iOS app, you might need to set these values.

Property or Setting
and Location in Product
Possible Values Description

Views
(Form Designer)

  • iPad
  • iPad Mini
  • iPhone 3.5
  • iPhone 4

Views allow you to customize the application for a given device or a type or device.
Sets the form factor used to display the form at design time in the Form Designer.
Allows you to lay out the controls for your app on the specific iOS form, such as iPad vs. iPhone.

Target Platform
(Projects Window)

  • iOS Simulator (which runs on the Mac)
    • Target
      • <Simulator 1>
      • <Simulator 2>
  • iOS Device - 32 bit (either iPhone or iPad)
    • Target
      • <Device 1>
      • <Device 2>
    • Configuration
      • Debug
      • Ad hoc
  • iOS Device - 64 bit (either iPhone or iPad)
    • Target
      • <Device 1>
      • <Device 2>
    • Configuration
      • Debug
      • Ad hoc
      • Application Store

For the iOS Simulator target platform, the target determines the form that the iOS simulator uses (such as iPad instead of iPhone, or vice versa).

For the iOS device target platforms (iOS Device - 32 bit and iOS Device - 64 bit):

  • When using either the Debug or the Ad hoc platform configurations, the target determines the specific iOS device used at run time.
  • When using the Application Store platform configuration, RAD Studio generates an application archive (.ipa file).

For more information, see Target Platforms Overview.

UIDeviceFamily

(One of the Key/Value pairs you can set on Project > Options > Version Info)

  • iPhone
  • iPad
  • iPhone & iPad

For the iOS Simulator and iOS Device, you need to set UIDeviceFamily.

This is an important setting if you are building an app that you want to be optimized for and laid out for a specific device, and simultaneously not optimized for and laid out for any other device. (That is, you would want to target iPad exclusively if your app requires more "real estate" than the iPhone screen provides.)

For example, setting UIDeviceFamily to iPad means that your app is designed to run only on an iPad, and not an iPhone.

  • The Tablet Master-Detail iOS app template is a good example of an app that is iPad only.
  • In the Phone Master-Detail iOS app template, UIDeviceFamily is set to iPhone only.

iOS Simulator
Hardware menu (on the Mac)

  • iPhone
  • iPad

Use this setting if you want to run an already deployed app on a different device in the iOS Simulator.

Does not override the UIDeviceFamily setting on the Version Info page.

Project > Options > Application

  • iPhone tab
  • iPad tab
  • Orientation tab

The iPad and iPhone tabs contain fields for setting the application icon and launch images (PNG files).
You can specify different size/shape images for iPhone and iPad.

The Orientation tab applies to any iOS form factor.

See Also