iOS核心笔记—CoreLocation框架-基础

1、CoreLocation框架简介：

?了解：在iOS开发中，要想使用地图和定位功能，必须基于2个框架进行开发。CoreLocation框架：主要用于地理定位；MapKit框架：主要用于地图展示。

1-1、CoreLocation框架功能：

?重要：CoreLocation框架着重于功能的实现，只有开发人员可以获取到对应的数据，用户是看不见、摸不着的；CoreLocation框架中所有的数据类型的前缀都是CL开头。

1-2、两个热门术语：

1-3、CoreLocation框架使用主要步骤：

?注意：只有使用了该框架里的某个类创建了一个对象，才会隐式的将该框架导入到项目中。

2、iOS8.0之前 - - - 定位功能：

1、?重要：iOS8.0之前，实现定位功能不需要向用户请求授权。

2、?了解：iOS8.0之前，版本即将被淘汰，不再做适配；而且iOS8.0以后的定位功能实现的代码可以直接运行在iOS8.0之前的设备上，不需要做任何修改；因为系统版本和Xcode版本问题，此处不再过于详细介绍iOS8.0之前的定位功能；只是列举大致实现步骤，详细步骤可以参阅iOS8.0之后的定为实现。

3、?了解：iOS8.0之前，当应用程序使用后台定位功能时，屏幕上方是否会出现蓝色横幅未做验证。

2-1、iOS8.0之前 - - - 前台定位：

2-1-1、详细步骤：

2-1-2、细节补充：

1、导入CoreLocation框架以及对应的主头文件。

1.  #import <CoreLocation/CoreLocation.h>

2、代理方法中无法定位原因：

?重要：①、CLLocationManager对象为局部变量；②、没有调用相应的方法开启定位功能；③、模拟器出现问题；④、其它未知原因导致。

2-2、iOS8.0之前 - - - 后台定位：

2-1、详细步骤：

2-2、开启后台模式两种方式：

?重要：其实，两种开启后台模式的方式，本质都是操作info.plist文件。

• ①、选中工程-> 前往target -> capabilities -> Background Modes -> 勾选location updates。
  

  ---

• ②、配置info.plist文件：
  ?了解：其实，两种开启后台模式的方式，本质都是操作info.plist文件。

2-3、细节补充：

?了解：①、需要使用Xcode7.0之前的版本，模拟器应选择iOS8.0之前的版本；②、iOS8.0之前后台定位，当应用退出到后台时，在屏幕上方应该会出现蓝色横幅（未验证，不过查阅大量资粮都未说明会有蓝色横幅）。

2-4、常见问题：

?注意：如果定位不到，对应的代理方法不执行；4中解决方案：①、检查模拟器是否为iOS8.0之前的系统版本，一定要使用iOS8.0之前的模拟器；②、检查模拟器是否有设置数据；③、检查代码是否存在逻辑错误、是否有设置代理、位置管理对象是否为局部变量；④、模拟器问题，请先将模拟器位置设为None，然后再次设置数据；或者，重置模拟器。

2-5、示例代码：

1.#import "ViewController.h"
2.#import <CoreLocation/CoreLocation.h>
3.
4.@interface ViewController ()<CLLocationManagerDelegate>
5.
6./** 位置管理者 */
7.@property (nonatomic, strong) CLLocationManager *lM;
8.
9.@end
10.
11.@implementation ViewController
12.
13.#pragma mark - 懒加载
14.- (CLLocationManager *)lM
15.{
16.    if (!_lM) {
17.        // 1. 创建位置管理者
18.        _lM = [[CLLocationManager alloc] init];
19.        // 1.1 代理, 通知, block
20.        _lM.delegate = self;
21.
22.        // 距离筛选器: 每隔多米定位一次
23.        _lM.distanceFilter = 100;
24.
25.        // 精确度越高, 越耗电, 定位时间越长
26.        _lM.desiredAccuracy = kCLLocationAccuracyBest;
27.    }
28.    return _lM;
29.}
30.
31.- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
32.{
33.    // 2. 使用位置管理者,开始更新用户位置
34.    // 默认只能在前台获取用户位置,
35.    // 勾选后台模式 location updates
36.    [self.lM startUpdatingLocation];
37.}
38.
39.#pragma mark - CLLocationManagerDelegate
40./**
41. *  更新到位置之后调用
42. *
43. *  @param manager   位置管理者
44. *  @param locations 位置数组
45. */
46.-(void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray *)locations
47.{
48.    NSLog(@"定位到了");
49.
50.    // 拿到位置,做一些业务逻辑操作
51.
52.    // 停止更新
53.    [manager stopUpdatingLocation];
54.}
55.@end

3、iOS8.0 ~ iOS9.0 - - - 定位功能：

3-1、iOS8.0 ~ iOS9.0 - - - 前台定位：

1、详细步骤：

2、细节补充：

?重要：①、从iOS8.0开始，应用开启定位功能需要主动请求前台定位授权；除了使用CLLocationManager对象调用requestWhenInUseAuthorization方法之外，还需要在info.plist文件中配置NSLocationWhenInUseUsageDescription的key（注意：千万不要出现空格），其value用以向用户说明应用程序使用定位功能主要用途（注意：value可以为空）；如果没有配置该键值对，将不会弹框获取用户授权。②、需要注意版本适配问题，模拟器运行环境应当为iOS8.0之后，包括iOS8.0。

3、示例代码：

1.#import "ViewController.h"
2.#import <CoreLocation/CoreLocation.h>
3.
4.@interface ViewController () <CLLocationManagerDelegate>
5./** 定位管理者 */
6.@property (strong, nonatomic) CLLocationManager *mgr;
7.
8.@end
9.
10.@implementation ViewController
11.
12.- (void)viewDidLoad {
13.    [super viewDidLoad];
14.
15.    // 1. 创建定位管理者对象, 创建对象调用init方法初始化时, 如无特殊操作; 可以使用new方法代替
16.    self.mgr = [CLLocationManager new];
17.
18.    // 2. 请求用户授权, 必须在info.plist文件配置键值对
19.    // NSLocationWhenInUseUsageDescription : 前台定位授权
20.    // requestWhenInUseAuthorization : 前台授权 ,使用应用时授权获取位置信息
21.    // NSLocationAlwaysUsageDescription : 前后台授权
22.    // requestAlwaysAuthorization : 前后台授权, 总是授权获取位置信息
23.    if ([self.mgr respondsToSelector:@selector(requestWhenInUseAuthorization)]) {
24.        [self.mgr requestWhenInUseAuthorization];
25.    }
26.
27.    // 3. 设置代理对象
28.    self.mgr.delegate = self;
29.
30.    // 4. 开启定位功能
31.    [self.mgr startUpdatingLocation];
32.}
33.
34.#pragma mark - <CLLocationManagerDelegate>
35./**
36. 第一次成功获取用户位置时便会来到此代理方法, 之后每隔一秒钟调用一次; 调用十分频繁
37.
38. @param manager 定位管理者对象
39. @param locations 用户所有位置对象(数组中每一个元素代表一个位置)
40. */
41.- (void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray<CLLocation *> *)locations
42.{
43.    NSLog(@"%@", locations);
44.
45.    // 1. 停止定位
46.    [self.mgr stopUpdatingLocation];
47.}
48.@end

3-2、iOS8.0 ~ iOS9.0 - - - 后台定位：

3-2-1、前台授权 + 开启后台模式：

?重要：①、一定要记得开启后台模式，否则，当应用程序退到后台模式时将不能进行定位操作；②、当APP退到后台，在屏幕上方会出现蓝色横幅，已提醒用户应用程序正在使用定位功能。

1、详细步骤：

2、开启后台模式两种方式：

?重要：其实，两种开启后台模式的方式，本质都是操作info.plist文件。

• ①、选中工程-> 前往target -> capabilities -> Background Modes -> 勾选location updates。

 

• ②、配置info.plist文件：

3、示例代码：

?重要：与前台定位的示例代码一致，只是，应用程序开启后台模式，能够在后台获取用户的位置信息；并在代理方法中执行相应的逻辑操作。

3-2-2、前后台授权：

?重要：①、iOS8.0之后应用程序使用后台定位功能，前后台授权级别高于前台授权级别；当同时使用两种授权方式时会有两次弹框提醒。②、使用前后台授权，无论应用程序是否开启后台模式；应用程序退到后台都能获取位置信息。③、使用前后台授权，当应用退到后台，在屏幕上方不会出现蓝色横幅。

1、详细步骤：

2、细节补充：

?重要：①、注意，在实际应用开发中可能需要版本适配；②、不要忘记配置info.plist文件，否则，将不会出现弹框获取用户授权。

4、iOS9.0之后 - - - 定位功能：

?了解：iOS9.0使用前台授权 + 开启后台模式实现后台定位功能有所改变，增加了新的步骤；需要设置CLLocationManager对象的allowsBackgroundLocationUpdates属性，代理对象还必须实现locationManager:didFailWithError:代理方法，以达到监听定位失败的错误信息。

4-1、iOS9.0之后 - - - 前台定位：

?了解：与iOS8.0 ~ iOS9.0前台定位实现步骤一致，并无任何新增变化；一定要注意使用前台定位功能需要获取用户授权，注意：需要配置info.plist文件，否则，将不会出现弹框提醒用户、获取用户授权。

4-2、iOS9.0之后 - - - 后台定位：

4-2-1、前台授权 + 开启后台模式：

1、前台授权 + 开启后台模式：

?重要：在前台定位授权的基础上，如果勾选了后台模式location updates之后，还需要额外设置属性allowsBackgroundLocationUpdates = YES；代理对象还必须实现locationManager:didFailWithError:代理方法，以达到监听定位失败的错误信息。使用allowsBackgroundLocationUpdates属性注意需要做版本适配，该属性为iOS9.0 ~。

2、示例代码：

1.// 5. 获取后台临时定位授权, 记得开启后台定位模式, 否则, 程序将会崩溃
2.if ([UIDevice currentDevice].systemVersion.doubleValue >= 9.0) {
3.    self.mgr.allowsBackgroundLocationUpdates = YES;
4.}

3、必须实现的代理方法：

1./**
2. 定位失败调用该代理方法
3.
4. @param manager 定位管理者对象
5. @param error 错误对象
6. */
7.- (void)locationManager:(CLLocationManager *)manager didFailWithError:(NSError *)error{
8.    if (error != nil) {
9.        NSLog(@"%@", error);
10.    }
11.}

?重要：没有实现该代理方法，程序将会崩溃。

4-2-2、前后台授权：

?重要：直接请求前后台定位授权，和iOS8.0 ~ iOS9.0之后一致；没有任何变化。注意：只能运行在iOS9.0之后的设备上，一定要注意版本适配。