iOS实现模拟定位功能的示例代码
前言
App中越来越多的功能依赖用户实际的位置,例如基于用户位置提供推荐数据、基于定位判断某些功能是否可用,但是在开发调试中XCode却没有提供自定义的模拟定位的功能,所以本文主要的目的是现实一个可以在开发调试过程中随时模拟定位的功能。
思路
我们在iOS的app开发中通常采用的是CLLocationManager来获取用户当前的位置,当然也可以采用MKMapView的showUserLocation来获取用户的位置,所以我们分别针对这两种情况分析。
CLLocationManager
采用CLLocationManager获取定位时,是根据CLLocationManagerDelegate中- (void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray<CLLocation *> *)locations的回调来获取到定位的。我们只需要在系统回调这个方法传递给业务代码的中间,插入一部分代码,来修改locations参数。原本的逻辑为系统回调->业务代码,现在变为系统回调->模拟定位模块->业务代码,就实现了无侵入式的实现模拟定位功能。为了实现这个逻辑,可以有以下几个思路。
1、 Runtime swizzle
因为业务代码是根据- (void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray<CLLocation *> *)locations方法来接受回调的,所以可以采用Runtime swizzle这个方法,来实现模拟定位的功能,但是我们中间组件是不知道业务代码中具体是哪个类,所以无法具体指定runtime swizzle哪个类,所以只能遍历所有的类,判断当前类的方法列表中是否有locationManager:didUpdateLocations:这个方法,如果存在则swizzle。
- 优点:便于理解。
- 缺点:需要遍历所有的类和类的方法列表。
2、中间代理对象
这种思路是Swizzle了CLLocationManager的setDelegate:方法,当调用setDelegate时,将真实的delegate object保存下来,再将我们定义的中间代理类swizzle delegate对象设置为CLLocationManager的delegate,这样当系统回调CLLocationManagerDelegate,会先回调到中间代理类swizzle delegate中,再由swizzle delegate将事件传递到真实的delegate object。
- 优点:相对于第一种方法,不需要遍历类和类的方法列表,只需swizzle CLLocationManager中的setDelegate:方法即可。
- 缺点:在中间代理类swizzle delegate中需要实现全部的CLLocationManagerDelegate方法,如果后续增加代理方法,仍需要修改这个类。
3、采用NSProxy实现中间代理对象
Objective-C中有2个基类,常用的就是NSObject,另一个就是NSProxy,NSProxy主要用于消息转发处理,所以采用NSProxy我们可以更好的处理方法二中的缺点。
3.1创建一个新的类MockLocationProxy,集成自NSProxy。
// MockLocationProxy.h #import <CoreLocation/CoreLocation.h> @interface MockLocationProxy : NSProxy @property (nonatomic, weak, readonly, nullable) id <CLLocationManagerDelegate> target; - (instancetype)initWithTarget:(id <CLLocationManagerDelegate>)target; @end
// MockLocationProxy.m #import "MockLocationProxy.h" @implementation MockLocationProxy - (instancetype)initWithTarget:(id<CLLocationManagerDelegate>)target { _target = target; return self; } @end
接着就来处理消息转发的逻辑,首先我们要知道我们想要的是什么效果,系统回调给MockLocationProxy,MockLocationProxy只处理locationManager:didUpdateLocations:,其他的消息都仍然交给原target。
所以我们在MockLocationProxy.m中添加以下方法:
// MockLocationProxy.m @implementation MockLocationProxy - (instancetype)initWithTarget:(id<CLLocationManagerDelegate>)target { _target = target; return self; } - (BOOL)respondsToSelector:(SEL)aSelector { if (aSelector == @selector(locationManager:didUpdateLocations:)) { return YES; } return [self.target respondsToSelector:aSelector]; } - (void)forwardInvocation:(NSInvocation *)invocation { SEL sel = invocation.selector; if ([self.target respondsToSelector:sel]) { [invocation invokeWithTarget:self.target]; } } - (NSMethodSignature *)methodSignatureForSelector:(SEL)sel { return [self.target methodSignatureForSelector:sel]; } #pragma mark - CLLocationManagerDelegate - (void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray<CLLocation *> *)locations { if ([self.target respondsToSelector:_cmd]) { // 模拟定位代码 CLLocation *mockLocation = [[CLLocation alloc] initWithLatitude:39.908722 longitude:116.397499]; locations = @[mockLocation]; [self.target locationManager:manager didUpdateLocations:locations]; } } @end
当消息发送给MockLocationProxy时,判断当前方法是否是locationManager:didUpdateLocations:,如果是,则MockLocationProxy响应事件,否则直接传递给原本的target。到此已经可以随时处理模拟定位。你只需要在模拟定位的代码做一些处理,就可以随时修改定位。
One more.
上述方法虽然可以模拟定位,但是每次修改模拟值都需重新build,那么有没有办法在运行时随时修改这个值呢?
当然可以,你只需要在你的项目中集成LLDebugTool,调用其中的Location模块,LLDebugTool提供了一个UI来随时修改这个模拟值,让你在调试时,随时模拟定位,LLDebugTool仍提供了很多其他的功能,如果你只需要模拟定位的功能,则只需要集成LLDebugTool/Location这个subspec就可以了。
后记
前言说过,定位除了CLLocationManager之外,MKMapView的showUserLocation也可以获取定位信息,那么如何解决这个问题呢? 你可以在LLDebugTool/Location中查看答案。