MonacaApp-Info.plist
You can configure your iOS app in MonacaApp-Info.plist file. For information on plist
file, please refer to Information Property List Files (Apple). This file is located under ios
folder inside your Monaca project as shown below:
For Cordova 6.2 or higher, MonacaApp-Info.plist
file is removed from Monaca framework. Therefore, in order to config iOS application settings, use Cordova Custom Config Plugin.
Inside MonacaApp-Info.plist
file, there are 3 main types of elements:
<key>
: Defines value (plistObject) and a combination of application configuration information.<array>
: You can have the array of values (plistObject).<dict>
: Key and combination of value (plistObject) are defined here.
For example:
Type List of Values (plistObject)
Types | Description |
string | String data type representing text. |
date | Date data type representing date and time. |
Integer | Integer number |
real | Floating data type representing a decimal number. |
data | Data type |
true | true boolean |
false | false boolean |
List of Keys
Key | Type | Description |
CFBundleDevelopmentRegion | string | Defines a native language of the developer. If the language of the user cannot be found, this value will be used as default. |
CFBundleDisplayName | string | Define a name of the application. It is a fully qualified name of the class that you extend from Application class. |
CFBundleExecutable | string | Defines the application executable file. |
CFBundleIconFile | string | Defines application icon file name. |
CFBundleIconFiles | <array>string | Defines icon file names used for iOS |
CFBundleIdentifier | string | Specifies a unique identifier for your application. The identifier must be a Uniform Type Identifier (UTI) as |
CFBundleInfoDictionaryVersion | string | Is the current version number of |
CFBundleName | string | Is a short display name of the app. It is limited to |
CFBundlePackageType | string | Is a 4-digit code used to describe application type. Set this value to |
CFBundleShortVersionString | string | Specifies the version number of your application. |
CFBundleSignature | string | Is a 4-digit code used to identify the app developer. |
CFBundleVersion | string | Is a build version number of the application. |
LSRequiresIPhoneOS | true | Indicates whether the application can only be run on iPhone or not. |
UISupportedInterfaceOrientations | <array>string | Specifies screen orientations for iPhone that are supported by the application. For iPad, use |
BackupWebStorage | string | Set to cloud to allow the web storage data to be backed up to iCloud, Set to none to not allow any backups of web storage. default is cloud |
Here are some keys and values you may need to configure in your iOS apps:
UISupportedInterfaceOrientations
Is used to set the screen orientation of your app:
Settings for iPhone
Settings for iPad
List of Orientation Values
Value | Description |
UIInterfaceOrientationLandscapeLeft | Landscape orientation aligned to the left side of the Home button. |
UIInterfaceOrientationLandscapeRight | Landscape orientation aligned to the right side of the Home button. |
UIInterfaceOrientationPortraitUpsideDown | Portrait orientation |
UIInterfaceOrientationPortrait | Portrait orientation in opposite direction from the normal portrait orientation. |
You can download a sample screen orientation file below:
Statusbar Setting
Value | Type | Default | Description |
UIStatusBarHidden | Boolean |
| If set to |
UIViewControllerBasedStatusBarAppearance | Boolean |
| If set to |
Last updated