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 程序默认支持的设备方向。
posted @ 2018-07-27 00:44  CH520  阅读(1541)  评论(0编辑  收藏  举报