Apple开发_Info.plist文件的常见配置
- 在创建一个新的Xcode工程后,会 在Supporting Files文件夹下自动生成一个工程名-Info.plist的文件,这个是对工程做一些运行期配置的文件(很重要,必须有该文件)。
- 如果使用文本编辑器打开这个文件,会发现这是一个XML格式的文本文件,使用Xcode的Open As->Source Code或者Property List可以进行编辑,本文会重点介绍一些在iOS开发中常见的的Info.plist的配置项。
1、设置启动图标(CFBundleIcons)
<key>CFBundleIcons</key>
<dict>
<key>CFBundlePrimaryIcon</key>
<dict>
<key>CFBundleIconFiles</key>
<array>
<string>Icon</string>
<string>Icon@2x</string>
<string>Icon_120@2x</string>
</array>
</dict>
</dict>
2、设置启动闪屏图片(UILaunchImages)
<key>UILaunchImages</key>
<array>
<dict>
<key>UILaunchImageMinimumOSVersion</key>
<string>7.0</string>
<key>UILaunchImageName</key>
<string>Default</string>
<key>UILaunchImageOrientation</key>
<string>Portrait</string>
<key>UILaunchImageSize</key>
<string>{320, 568}</string>
</dict>
<dict>
<key>UILaunchImageMinimumOSVersion</key>
<string>7.0</string>
<key>UILaunchImageName</key>
<string>Default</string>
<key>UILaunchImageOrientation</key>
<string>Portrait</string>
<key>UILaunchImageSize</key>
<string>{320, 480}</string>
</dict>
</array>
3、设置版本号相关
-
(1)设置Bundle的版本号(Bundle versions string, short)。
- 一般包含该束的主、次版本号,这个字符串的格式通常是“n.n.n”(n表示某个数字,如1.1.1)。第一个数字是束的主要版本号,另两个是次要版本号。该关键字的值会被显示在Cocoa应用程序的关于对话框中。该关键字不同于CFBundleVersion,它指定了一个特殊的创建号。而CFBundleShortVersionString的值描述了一种更加正式的并且不随每一次创建而改变的版本号。
<key>CFBundleShortVersionString</key> <string>1.0</string>
-
(2)设置应用程序版本号(Bundle version)。
- 每次部署应用程序的一个新版本时,将会增加这个编号,用于标识不同的版本。
<key>CFBundleVersion</key> <string>1.0</string>
4、设置字体相关(Fonts provided by application)
- 在iOS应用中需要使用系统提供的字体之外的字体,可以将字体文件(.ttf/.odf)复制到项目文件中,另外需要在Info.plist中添加Fonts provided by application的项,对应的源码文件如下:
<key>UIAppFonts</key>
<array>
<string>华文行楷.ttf</string>
<string>华文新魏.ttf</string>
<string>黑体_GB2312.ttf</string>
</array>
-
P.S关于如何使用系统支持的字体信息:
- (1)在调用字体的时候,要使用字体名。字体名不是文件名,而是字体的Family Name。Family Name可以在Font Book中查看。
label.font = [UIFont fontWithName:@"字体名称" size:16.0];
- (2)遍历出系统支持的全部字体
NSArray *familyNames = [[NSArray alloc] initWithArray:[UIFont familyNames]]; for(int indFamily = 0; indFamily < familyNames.count; ++indFamily) { NSLog(@"Family Name: %@", [familyNames objectAtIndex:indFamily]); NSString *fontFamilyName = [familyNames objectAtIndex:indFamily]; NSArray *fontNames = [[NSArray alloc] initWithArray:[UIFont fontNamesForFamilyName:fontFamilyName]]; for(int indFont = 0; indFont < fontNames.count; ++indFont) { NSLog(@" Font Name: %@", [fontNames objectAtIndex:indFont]); } }
5、设置应用名称(Bundle display name)
<key>CFBundleDisplayName</key>
<string>应用程序名称</string>
- 可以通过在InfoPlist.strings中使用配置让应用在不同的语言环境下显示不同的应用名称,如在English中使用CFBundleDisplayName="Hello World";配置应用程序的名称为Hello World,在Chinese的环境下使用CFBundleDisplayName="你好世界";配置应用程序的名称为你好世界。
6、设置应用标识号(Bundle identifier)
<key>CFBundleIdentifier</key>
<string>com.devzeng.demo</string>
7、设置应用支持的屏幕方向(Supported interface orientations)
- iOS应用程序支持以下四个方向的设置:UIInterfaceOrientationPortrait(默认竖直方向,HOME键向下)、UIInterfaceOrientationLandscapeLeft(横屏靠左)、UIInterfaceOrientationLandscapeRight(横屏向右)和UIInterfaceOrientationPortraitUpsideDown(竖直方向倒置,HOME键向上)
- 对应的配置源码如下:
<key>UISupportedInterfaceOrientations</key>
<array>
<string>UIInterfaceOrientationPortrait</string>
<string>UIInterfaceOrientationLandscapeLeft</string>
<string>UIInterfaceOrientationLandscapeRight</string>
<string>UIInterfaceOrientationPortraitUpsideDown</string>
</array>
8、设置应用程序是否支持后台运行(Application does not run in background)
- 通过UIApplicationExitsOnSuspend可以设置iOS的应用程序进入到挂起状态下是否立即退出,设置为YES表示不支持后台运行退出到后台立即退出,设置为NO表示支持后台运行。
-
(1)设置支持后台运行
<key>UIApplicationExitsOnSuspend</key>
<false/>
-
(2)设置不支持后台运行
<key>UIApplicationExitsOnSuspend</key>
<true/>
9、相机,通讯录,麦克风等权限设置
- 在开发使用真机权限过程中,有时候忘记配置,会出现程序崩溃的问题
[access] This app has crashed because it attempted to access privacy-sensitive data without a usage description.
The app's Info.plist must contain an NSPhotoLibraryUsageDescription key with a string value explaining to the user how the app uses this data.
- 这个是拍照动作引起的崩溃,在升Xcode+iOS10之前都是好的,升级之后,需要在plist文件中添加相册权限。相应的麦克风,通讯录,如果项目中涉及到了,也需要添加相应的权限。报错的相应key值:
- 通信录:NSContactsUsageDescription
- 麦克风:NSMicrophoneUsageDescription
- 相册:NSPhotoLibraryUsageDescription
- 这里仅以相册的为例:
- plist文件里面添加,Privacy - Photo Library Usage Description,Value值为描述,弹出的提示框会显示出来。
- 升到iOS10之后,需要设置权限的有:
- 麦克风权限:Privacy - Microphone Usage Description 是否允许此App使用你的麦克风?
- 相机权限: Privacy - Camera Usage Description 是否允许此App使用你的相机?
- 相册权限: Privacy - Photo Library Usage Description 是否允许此App访问你的媒体资料库?
- 通讯录权限: Privacy - Contacts Usage Description 是否允许此App访问你的通讯录?
- 蓝牙权限:Privacy - Bluetooth Peripheral Usage Description 是否许允此App使用蓝牙?
- 语音转文字权限:Privacy - Speech Recognition Usage Description 是否允许此App使用语音识别?
- 日历权限:Privacy - Calendars Usage Description
- 定位权限:Privacy - Location When In Use Usage Description
- 定位权限: Privacy - Location Always Usage Description
- 位置权限:Privacy - Location Usage Description
- 媒体库权限:Privacy - Media Library Usage Description
- 健康分享权限:Privacy - Health Share Usage Description
- 健康更新权限:Privacy - Health Update Usage Description
- 运动使用权限:Privacy - Motion Usage Description
- 音乐权限:Privacy - Music Usage Description
- 提醒使用权限:Privacy - Reminders Usage Description
- Siri使用权限:Privacy - Siri Usage Description
- 电视供应商使用权限:Privacy - TV Provider Usage Description
- 视频用户账号使用权限:Privacy - Video Subscriber Account Usage Description
10、通用解释
-
10.1
-
Localiztion native development region --- CFBundleDevelopmentRegion 本地化相关,如果⽤户所在地没有相应的语言资源,则用这个key的value来作为默认
-
Bundle display name --- CFBundleDisplayName 设置程序安装后显示的名称。应⽤程序名称限制在10-12个字符,如果超出,将被显示缩写名称。
-
Executaule dile -- CFBundleExecutable 程序安装包的名称
-
Bundle identidier --- CFBundleIdentidier 该束的唯一标识字符串,该字符串的格式类似 com.yourcompany.yourapp,
- 如果使⽤用模拟器跑你的应用,这个字段没有用处,
- 如果你需要把你的应⽤部署到设备上,你必须⽣成一个证书,
- ⽽而在⽣生成证书的时候,在apple的⽹网站上需要增加相应的app IDs.
- 这⾥有一个字段Bundle identidier,如果这个Bundle identidier是一个完整字符串,
- 那么文件中的这个字段必须和后者完全相同,如果app IDs中的字段含有通配符*,那么文件中的字符串必须符合后者的描述。
-
InfoDictionary version --- CFBundleInfoDictionaryVersion Info.plist 格式的版本信息。
-
10.2
- Bundle name --- CFBundleName 产品名称
- Bundle OS Type code -- CFBundlePackageType ⽤来标识束类型的四个字母长的代码
- Bundle versions string, short --- CFBundleShortVersionString ⾯向用户市场的束的版本字符串
- Bundle creator OS Type code --- CFBundleSignature 用来标识创建者的四个字母长的代码
- Bundle version --- CFBundleVersion 应⽤程序版本号,每次部署应用程序的一个新版本时, 将会增加这个编号,在app store上用的。
-
10.3
- Application require iPhone environment -- LSRequiresIPhoneOS 用于指示程序包是否只能运行在iPhone OS 系统上。Xcode自动加入这个键,并将它的值设置为true。您不应该改变这个键的值。
- Main storybard dile base name -- UIMainStoryboardFile 这是一个字符串,指定应用程序主nib文件的名称。
- supported interface orientations -- UISupportedInterfaceOrientations 程序默认支持的设备方向。