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.<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist>
<dict>
<key>key</key>
<value-type>value</value-type>
...
<key>key</key>
<array>
<value-type>value</value-type>
<value-type>value</value-type>
</array>
...
</dict>
</plist>
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:
<plist>
<dict>
...
<key>XXX</key>
<string>The value(plistObject) corresponding to key(XXX)</sting>
...
<key>YYY</key>
<array>
<string>The 1st value(plistObject) corresponding to key(YYY)</string>
<string>The 2nd value(plistObject) corresponding to key(YYY)</string>
<string>The 3rd value(plistObject) corresponding to key(YYY)</string>
<string>The 4th value(plistObject) corresponding to key(YYY)</string>
</array>
...
</dict>
</plist>
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 |
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 3.2 or later. The correct file will be chosen depending on the size of the device screen resolution. |
CFBundleIdentifier | string | Specifies a unique identifier for your application. The identifier must be a Uniform Type Identifier (UTI) as com.monaca.MyApp . |
CFBundleInfoDictionaryVersion | string | Is the current version number of MonacaApp-Info.plist file. |
CFBundleName | string | Is a short display name of the app. It is limited to 16 characters at most. |
CFBundlePackageType | string | Is a 4-digit code used to describe application type. Set this value to APPL for application project. |
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 UISupportedInterfaceOrientations~ipad . |
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:
Is used to set the screen orientation of your app:
- Settings for iPhone...<key>UISupportedInterfaceOrientations</key><array><string>UIInterfaceOrientationLandscapeLeft</string><string>UIInterfaceOrientationLandscapeRight</string><string>UIInterfaceOrientationPortraitUpsideDown</string><string>UIInterfaceOrientationPortrait</string></array>...
- Settings for iPad...<key>UISupportedInterfaceOrientations~ipad</key><array><string>UIInterfaceOrientationLandscapeLeft</string><string>UIInterfaceOrientationLandscapeRight</string><string>UIInterfaceOrientationPortraitUpsideDown</string><string>UIInterfaceOrientationPortrait</string></array>...
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:
UISupportedInterfaceOrientations.zip
700B
Binary
Screen Orientation File
Value | Type | Default | Description |
UIStatusBarHidden | Boolean | false | If set to true , the status bar at the top of the application will be hidden. If UIStatusBarHidden set to true and UIViewControllerBasedStatusBarAppearance set to false , the status bar at the top of the app will be hidden. |
UIViewControllerBasedStatusBarAppearance | Boolean | false | If set to true , the status bar at the top of the application will be hidden. Set to true in order to use StatusBar Plugin. |
Last modified 2yr ago