User Interface

Configure an app's scenes, storyboards, icons, fonts, and other user interface elements.

Overview

You define the user interface that your app presents during normal operation with a combination of code and storyboards. However, the system needs to know a few things about your app’s user interface before execution begins. For example, on some platforms, you have to specify what device orientations your app supports and what the system should display while your app launches. You add keys to your app’s Information Property List file to control certain aspects of its user interface.

Topics

Main User Interface

property list key UIApplicationSceneManifest

The information about the app's scene-based life-cycle support.

Name: Application Scene Manifest
property list key NSMainStoryboardFile

The name of an app's storyboard resource file.

Name: Main storyboard file base name
property list key UIMainStoryboardFile

The name of the app’s main storyboard file.

Name: Main storyboard file base name
property list key NSMainNibFile

The name of an app’s main user interface file.

Name: Main nib file base name
property list key LSUIElement

A Boolean value indicating whether the app is an agent app that runs in the background and doesn't appear in the Dock.

Name: Application is agent (UIElement)

Launch Interface

property list key UILaunchStoryboardName

The filename of the storyboard from which to generate the app’s launch image.

Name: Launch screen interface file base name
property list key LSUIPresentationMode

The initial user-interface mode for the app.

Name: Application UI Presentation Mode

Icons

property list key CFBundleIcons

Information about all of the icons used by the app.

Name: Icon files (iOS 5)
property list key CFBundleIconFiles

The names of the bundle’s icon image files.

Name: Icon files
property list key CFBundleIconFile

The file containing the bundle's icon.

Name: Icon file
property list key CFBundleIconName

The name of the asset that represents the app icon.

Name: Icon Name
property list key UIPrerenderedIcon

A Boolean value indicating whether the app’s icon already contains a shine effect.

Name: Icon already includes gloss effects

Orientation

property list key UIInterfaceOrientation

The initial orientation of the app’s user interface.

Name: Initial interface orientation
property list key UISupportedInterfaceOrientations

The interface orientations the app supports.

Name: Supported interface orientations

Styling

property list key UIUserInterfaceStyle

The user interface style for the app.

Name: User Interface Style
property list key UIViewEdgeAntialiasing

A Boolean value indicating whether Core Animation layers use antialiasing when drawing a layer that's not aligned to pixel boundaries.

Name: Renders with edge antialiasing
property list key UIWhitePointAdaptivityStyle

The app’s white point adaptivity style, enabled on devices with True Tone displays.

Name: White Point Adaptivity Style
property list key UIViewGroupOpacity

A Boolean value indicating whether Core Animation sublayers inherit the opacity of their superlayer.

Name: Renders with group opacity

Fonts

property list key ATSApplicationFontsPath

The location of a font file or directory of fonts in the bundle’s Resources folder.

Name: Application fonts resource path
property list key UIAppFonts

App-specific font files located in the bundle and that the system loads at runtime.

Name: Fonts provided by application

Status Bar

property list key UIStatusBarHidden

A Boolean value indicating whether the status bar is initially hidden when the app launches.

Name: Status bar is initially hidden
property list key UIStatusBarStyle

The style of the status bar as the app launches.

Name: Status bar style
property list key UIStatusBarTintParameters

The status bar tint.

Name: Status bar tinting parameters
property list key UIViewControllerBasedStatusBarAppearance

A Boolean value indicating whether the status bar appearance is based on the style preferred for the current view controller.

Name: View controller-based status bar appearance

Preferences

property list key NSPrefPaneIconFile

The name of an image file used to represent a preference pane in the System Preferences app.

Name: Preference Pane icon file
property list key NSPrefPaneIconLabel

The name of a preference pane displayed beneath the preference pane icon in the System Preferences app.

Name: Preference Pane icon label

Graphics

property list key UIAppSupportsHDR

A Boolean value indicating whether the app supports HDR mode on Apple TV 4K.

Name: Supports HDR color mode
property list key NSHighResolutionCapable

A Boolean value indicating whether the Cocoa app supports high-resolution displays.

Name: High Resolution Capable
property list key NSSupportsAutomaticGraphicsSwitching

A Boolean value indicating whether an OpenGL app may utilize the integrated GPU.

Name: Supports Automatic Graphics Switching

QuickLook

property list key QLNeedsToBeRunInMainThread

A Boolean value indicating whether a Quick Look app's generator can be run in threads other than the main thread.

Name: Quick Look needs to be run in main thread
property list key QLPreviewHeight

A hint at the height, in points, of a Quick Look app's previews.

Name: Quick Look preview height
property list key QLPreviewWidth

A hint at the width, in points, of a Quick Look app's previews.

Name: Quick Look preview width
property list key QLSupportsConcurrentRequests

A Boolean value indicating whether a Quick Look app's generator can handle concurrent thumbnail and preview requests.

Name: Quick Look supports concurrent requests
property list key QLThumbnailMinimumSize

The minimum size, in points, along one dimension of thumbnails for a Quick Look app's generator.

Name: Quick Look thumbnail minimum size

Deprecated Keys

property list key UILaunchImages

A dictionary containing information about launch images.

Deprecated

See Also

Core Settings

Bundle Configuration

Define basic characteristics of a bundle, like its name, type, and version.

App Execution

Control app launch, execution, and termination.