About Info.plist Keys and Values

Describes the keys for a bundle

At a Glance

This document describes the keys and corresponding values that you can include in an information property list file. This document also includes an overview of information property list files to help you understand their importance and to provide tips on how to configure them.

The Info.plist File Configures Your App

Every app and plug-in uses an Info.plist file to store configuration data in a place where the system can easily access it. macOS and iOS use Info.plist files to determine what icon to display for a bundle, what document types an app supports, and many other behaviors that have an impact outside the bundle itself.

Relevant chapter: About Information Property List Files

Core Foundation Keys Describe Common Behavior

There are many keys that you always specify, regardless of the type of bundle you are creating. Those keys start with a CF prefix and are known as the Core Foundation keys. Xcode includes the most important keys in your Info.plist automatically but there are others you must add manually.

Relevant chapter: Core Foundation Keys

Launch Services Keys Describe Launch-Time Behavior

Launch Services provides support for launching apps. To do this, though, it needs to know information about how your app wants to be launched. The Launch Services keys describe the way your app prefers to be launched.

Relevant chapter: Launch Services Keys

Cocoa Keys Describe Behavior for Cocoa and Cocoa Touch Apps

The Cocoa and Cocoa Touch frameworks use keys to identify high-level information such as your app’s main nib file and principal class. The Cocoa keys describe those and other keys that affect how the Cocoa and Cocoa Touch frameworks initialize and run your app.

Relevant chapter: Cocoa Keys

macOS Keys Describe Behavior for macOS Apps

Some macOS frameworks use keys to modify their basic behavior. Developers of Mac apps might include these keys during testing or to modify certain aspects of your app’s behavior.

Relevant chapter: macOS Keys

iOS Keys Describe Behavior for iOS Apps

An iOS app communicates a lot of information to the system using Info.plist keys. Xcode supplies a standard Info.plist with the most important keys but most apps need to augment the standard file with additional keys describing everything from the app’s initial orientation to whether it supports file sharing.

Relevant chapter: iOS Keys

watchOS Keys Describe Behavior for Watch Apps

Use the Info.plist keys associated with the watchOS frameworks to configure your Watch apps and WatchKit extensions.

Relevant chapter: watchOS Keys

App Extension Keys Describe Behavior for iOS and macOS App Extensions

App extensions let you make custom behaviors available in other apps and in system facilities such as notification center. Xcode’s app extension templates each supply a standard Info.plist file with the most important keys, but you can specify additional keys that describe custom behavior for your app extensions.

Relevant chapter: App Extension Keys

About Info.plist Keys and Values

At a Glance

See Also