开发 iOS 定位SDK 开发指南 创建工程 权限配置

权限配置 最后更新时间: 2021年11月01日

一、前言

大数据时代,用户对自己的隐私安全越来越关注。所以,随着 iOS 系统更新,苹果对用户定位隐私相关的权限控制持续升级。

二、定位权限

1、iOS8.*

  • 前台定位
    • 需要在info.plist配置NSLocationWhenInUseUsageDescription字段;
    • 注意:此权限下,如果Xcode勾选 Capabilities -> UIBackgroundModes > Location updates,则app退到后台仍可获取定位数据,但此时在手机上方会有定位小蓝条提示;
  • 后台定位
    • 需要在info.plist配置NSLocationAlwaysUsageDescription字段;
    • 需要Xcode勾选 Capabilities -> UIBackgroundModes > Location updates;

2、iOS9.*与iOS10.*

  • 前台定位
    • 需要在info.plist配置NSLocationWhenInUseUsageDescription字段; 
    • 注意:此权限下,如果Xcode勾选 Capabilities -> UIBackgroundModes > Location updates并且allowsBackgroundLocationUpdates设为YES,则app退到后台仍可获取定位数据,但此时在手机上方会有定位小蓝条提示;
  • 后台定位
    • 需要在info.plist配置NSLocationAlwaysUsageDescription字段;
    • 需要Xcode勾选 Capabilities -> UIBackgroundModes > Location updates;
    • 需要设置allowsBackgroundLocationUpdates为YES;
  • 与iOS8.*版本相比不同点
    • iOS9.*后台增加了allowsBackgroundLocationUpdates属性,可以认为在iOS8.*下allowsBackgroundLocationUpdates永远为YES;

3、iOS11.*与iOS12.*

  • 前台定位
    • 需要在info.plist配置NSLocationWhenInUseUsageDescription字段;
    • 注意:此权限下,如果Xcode勾选 Capabilities -> UIBackgroundModes > Location updates并且allowsBackgroundLocationUpdates设为YES,则app退到后台仍可获取定位数据,但此时在手机上方会有定位小蓝条提示,此小蓝条不可隐藏;
  • 后台定位
    • 需要在info.plist配置NSLocationWhenInUseUsageDescription、NSLocationAlwaysAndWhenInUseUsageDescription字段;
    • 需要Xcode勾选 Capabilities -> UIBackgroundModes > Location updates;
    • 需要设置allowsBackgroundLocationUpdates为YES;
    • 注意:此权限下,当app在后台时,系统默认不展示定位小蓝条,可通过showsBackgroundLocationIndicator控制小蓝条是否显示;
  • 与iOS10.*版本相比不同点
    • iOS11.*变更了后台定位权限配置字段;
    • iOS11.*以后如果申请后台定位,info.plist需要同时配置NSLocationWhenInUseUsageDescription、NSLocationAlwaysAndWhenInUseUsageDescription两个字段;
    • iOS11.*增加了showsBackgroundLocationIndicator属性,当拥有后台定位权限时,用于控制定位小蓝条是否显示。可以认为在iOS10.*之前showsBackgroundLocationIndicator永远为NO; 

4、iOS13.*

  • 前台定位
    • 需要在info.plist配置NSLocationWhenInUseUsageDescription字段;
    • 注意:权限申请弹窗与之前版本不一致,新增了允许一次选项;如果用户选择允许一次后,下次在使用app时,仍可重新调用API申请定位权限;如下图 
  • 后台定位
    • 需要在info.plist配置NSLocationWhenInUseUsageDescription、NSLocationAlwaysAndWhenInUseUsageDescription字段;
    • 需要Xcode勾选 Capabilities -> UIBackgroundModes > Location updates;
    • 需要设置allowsBackgroundLocationUpdates为YES;
  • 与iOS12.*版本相比不同点
    • 使用应用期间的定位权限增加了允许一次选项;
    • 不能直接申请后台定位权限,需要用户先选择应用使用期间的定位权限后,在进行权限升级;

5、iOS14.*

  • 前台定位
    • 需要在info.plist配置NSLocationWhenInUseUsageDescription字段;
    • 注意:权限申请弹窗与之前版本不一致,新增了精确位置开关,新增了小地图展示当前位置;小地图的显示,支持在手机定位设置中选择,如果选择关闭不显示则手机中所有app都不显示此小地图。如下图 :


  • 后台定位
    • 需要在info.plist配置NSLocationWhenInUseUsageDescription、NSLocationAlwaysAndWhenInUseUsageDescription字段;
    • 需要Xcode勾选 Capabilities -> UIBackgroundModes > Location updates;
    • 需要设置allowsBackgroundLocationUpdates为YES;
  • 新增精度权限
    • 需要在info.plist配置NSLocationTemporaryUsageDescriptionDictionary,如下:
<key>NSLocationTemporaryUsageDescriptionDictionary</key>
<dict>
  <key>ExampleUsageDescription</key>
  <string>This app needs accurate location so it can verify that you are in a supported region.</string>
  <key>AnotherUsageDescription</key>
  <string>This app needs accurate location so it can show you relevant results.</string>
</dict>
  • 新增属性字段@property (nonatomic, readonly) CLAccuracyAuthorization accuracyAuthorization API_AVAILABLE(ios(14.0), macos(11.0), watchos(7.0), tvos(14.0));可以获取当前的定位精度权限。
  • 在app已经获得定位权限之后,并且当前用户选择的是模糊定位,则允许应用申请一次临时精确定位权限,申请api为- (void)requestTemporaryFullAccuracyAuthorizationWithPurposeKey:(NSString *)purposeKey completion:(void(^)(NSError *))completion; 其中purposeKey既为plist中配置字典中的key,可以有多个,对应app中不同的定位需求场景;注意:此API不能用于申请定位权限,只能用于从模糊定位升级为精确定位;申请定位权限只能调用requestWhen或requestAlways,如果没有获得定位权限,直接调用此API无效。如下图:
  • 如果app默认不使用精确定位,则可以在info.plist中配置NSLocationDefaultAccuracyReduced字段,配置该字段后,申请定位权限的小地图中不在有精确定位的开关,即为关。如下面图示
    • 需要注意该字段类型为Boolean,如果为其他类型则不起效;
    • 配置该字段后,申请定位权限的小地图左上角则没有精确开关,默认关闭,如下面图示。但是如果info.plist中配置了NSLocationTemporaryUsageDescriptionDictionary,则仍可以申请临时的精确定位权限;
<key>NSLocationDefaultAccuracyReduced</key> <true/>
  • 与iOS13.*版本相比不同点
    • 权限申请弹窗与之前版本不一致;
    • 新增精度权限相关plist设置、授权、读取;
    • 新增临时一次从模糊定位升级精确定位API;
    • 新增定位权限变更回调;

7、总结

  • 定位权限注意事项
    • iOS11以后如果申请后台定位,info.plist需要同时配置NSLocationWhenInUseUsageDescription、NSLocationAlwaysAndWhenInUseUsageDescription两个字段;
    • 自2019年下半年起,苹果商店上架app对后台定位权限增加限制,如果info.plist中不包含NSLocationAlwaysUsageDescription/NSLocationAlwaysAndWhenInUseUsageDescription字段,则在app代码中不能出现符号requestAlwaysAuthorization,否则上架审核不通过;
  • Info.plist 中的字段总结

 iOS版本 

 NSLocationWhenInUseUsageDescription 

 NSLocationAlwaysUsageDescription 

 NSLocationAlwaysAndWhenInUseUsageDescription 

 NSLocationTemporaryUsageDescriptionDictionary 

 iOS 8 

 YES 

 YES 

 × 

 × 

 iOS 9

 YES 

 YES 

 × 

 × 

 iOS 10

 YES 

 YES 

 × 

 × 

 iOS 11

 YES 

 × 

 YES 

 × 

 iOS 12

 YES 

 × 

 YES 

 × 

 iOS 13

 YES 

 × 

 YES 

 × 

 iOS 14

 YES 

 × 

 YES 

 YES 

  • 不同系统版本调用定位权限API差异

iOS8.0 

 

-

 Capabilities 关 

 Capabilities 开 

 requestAlwaysAuthorization 

 可以前台定位、不可以后台定位、无蓝条  

 可以前台定位、可以后台定位、无蓝条 

 requestWhenInUseAuthorization  

 可以前台定位、不可以后台定位、无蓝条 

 可以前台定位、可以后台定位、有蓝条 

 无/用户拒绝  

 无任何定位  

 无任何定位 

iOS9.0 - iOS12.0


 Capabilities 关 

 Capabilities 开 

 allowsBackgroundLocationUpdates关  

 allowsBackgroundLocationUpdates开 

 allowsBackgroundLocationUpdates关 

 allowsBackgroundLocationUpdates开 

 requestAlwaysAuthorization 

 可以前台定位、不可以后台定位、无蓝条  

 iOS抛出Crash  

 可以前台定位、不可以后台定位、无蓝条 

 可以前台定位、可以后台定位、无蓝条 

 requestWhenInUseAuthorization 

 

可以前台定位、不可以后台定位、无蓝条 

 iOS抛出Crash 

 可以前台定位、不可以后台定位、无蓝条 

 可以前台定位、可以后台定位、有蓝条 

 无/用户拒绝 

 无任何定位  

 iOS抛出Crash  

 无任何定位 

 无任何定位 

三、隐私合规

 隐私合规点击此处查看 

返回顶部 示例中心 常见问题 智能客服 公众号
二维码