iOS全埋点解决方案-手势采集

浅沫记忆

前言
​随着科技以及业务的发展，手势的应用也越来越普及，因此对于数据采集，我们要考虑如果通过全埋点来实现手势的采集。
一、手势识别器
​苹果为了降低开发者在手势事件处理方面的开发难度，定义了一个抽象类 UIGestureRecognizer 来协助开发者。UIGestureRecognizer 是具体手势识别器的抽象基类，它定义了一组可以为所有具体手势识别器配置的常见行为。它还可以通过设置委托（即实现了 UIGestureRecognizerDelegate 协议的对象），来支持对某些行为进行更细粒度的定制。
​手势识别器必须被添加在一个特定的视图上（比如 UILabel、UIImageView 等控件），即需要通过调用 UIView 类中的 - addGestureRecognizer: 方法进行添加。手势识别器也是用了 Target-Action 设计模式。当我们为一个手势识别器添加一个或者多个 Target-Action 后，在视图上进行触摸操作时，一旦系统识别了该手势，就会向所有的 Target 对象发送消息，并执行 Action 方法。虽然手势识别器和 UIControl 类一样，都是使用了 Target-Action 设计模式，但是手势识别器并不会将消息交由 UIApplication 对象来进行发送。因此，我们无法使用与 UIControl 控件相同的处理方式，即通过响应者链的方式来实现对手势操作的全埋点。
​由于 UIGestureRecognizer 是一个抽象基类，所以它并不会处理具体的手势。因此，对于轻拍（UITapGestureRecognizer）、长按（UILongPressGestureRecognizer）等具体的手势触摸事件，需要使用相应的子类即具体的手势识别器进行处理。
常见的具体手势识别器有：

• UITapGestureRecognizer：轻拍手势
  
• UILongPressGestureRecognizer：长按手势
  
• UIPinchGestureRecognizer：捏合（缩放）手势
  
• UIRotationGestureRecognizer：旋转手势
  
• UISwipeGestureRecognizer：轻扫手势
  
• UIPanGestureRecognizer：平移手势
  
• UIScreenEdgePanGestureRecognizer：屏幕边缘平移手势
  

​给上面所有的具体手势识别器添加 Target-Action 的方法都是相同的，常见的主要是通过以下的两个方法进行添加。

• initWithTarget:target action:
  
• addTarget:action:
  详细的定义参考如下：

  /**
  指定初始化方法
  通过添加一个 Target-Action 进行初始化，
  当初始化的手势识别器对象，识别到触摸手势时，会向 Target 对象发送消息，即调用 Action 方法
  @param target 需要发送消息的 Target 对象
  @param action 向 Target 对象发送的消息，即方法名
  @return 初始化的对象
  */
  - (instancetype)initWithTarget:(nullable id)target action:(nullable SEL)action NS_DESIGNATED_INITIALIZER;
  /**
  向一个手势识别器添加一个 Target-Action
  可以多次调用此方法，给一个手势识别器对象添加多个 Target-Action 。
  如果已经添加了一个 Target-Action，再次添加相同的 Target-Action 时，会被忽略。
  @param target 需要发送消息的 Target 对象
  @param action 向 Target 对象发送的消息，即方法名
  */
  - (void)addTarget:(id)target action:(SEL)action;

​    在实际的开发过程中，使用比较多的是 UITapGestureRecognizer 和 UILongPressGestureRecognizer 两个手势识别器，这两个手势识别器分别是处理轻拍手势和长按手势。
二、手势全埋点
​在数据采集中，一般只需要采集常见控件（UILabel、UIImageView）的轻拍和长按手势。
所以，我们分别介绍如何实现控件轻拍和长按手势的全埋点。
2.1 UITapGestureRecognizer 全埋点
​为了采集控件的轻拍手势，我们可以通过 Method Swizzling 交换 UITapGestureRecognizer 类的添加 Target-Action 的方法，从而可以添加一个新的 Target-Action，并在新添加的 Action 方法中触发 $AppClick 事件，从而就可以达到采集控件轻拍手势全埋点的效果。
在 UITapGestureRecognizer 类中，用于添加 Target-Action 方法有两个：
· - initWithTarget:action:
· - addTarget:action:
因此，我们需要对这两个方法分别进行交换。
第一步：创建 UITapGestureRecognizer 分类 UIGestureRecognizer+SensorsData，并实现 +load 类方法，在 + load方法中，进行 - initWithTarget:action: 和 - addTarget:action: 的方法交换。

#import "UIGestureRecognizer+SensorsData.h"
#import "NSObject+SASwizzler.h"
#import "SensorsAnalyticsSDK+Track.h"
@implementation UITapGestureRecognizer (SensorsData)
+ (void)load {
  [UITapGestureRecognizer sensorsdata_swizzleMethod:@selector(sensorsdata_initWithTarget:action:) withMethod:@selector(initWithTarget:action:)];
  [UITapGestureRecognizer sensorsdata_swizzleMethod:@selector(addTarget:action:) withMethod:@selector(sensorsdata_addTarget:action:)];
}
- (instancetype)sensorsdata_initWithTarget:(id)target action:(SEL)action {
  [self sensorsdata_initWithTarget:target action:action];
  [self addTarget:target action:action];
  return self;
}
- (void)sensorsdata_addTarget:(id)target action:(SEL)action {
  [self sensorsdata_addTarget:target action:action];
  
  // 新增 Target-Action, 用于触发 $AppClick 事件
  [self sensorsdata_addTarget:self action:@selector(sensorsdata_trackTapGestureAction:)];
}
- (void)sensorsdata_trackTapGestureAction:(UITapGestureRecognizer *)sender {
  [[SensorsAnalyticsSDK sharedInstance] trackAppClickWithView:view properties:nil];
}

第二步：在 - sensorsdata_trackTapGestureAction: 方法中判断要采集的控件

- (void)sensorsdata_trackTapGestureAction:(UITapGestureRecognizer *)sender {
  UIView *view = sender.view;
  // 暂定只采集 UILabel 和 UIImageView
  BOOL isTrackClass = [view isKindOfClass:UILabel.class] || [view isKindOfClass:UIImageView.class];
  if (!isTrackClass) {
    return;
  }
  [[SensorsAnalyticsSDK sharedInstance] trackAppClickWithView:view properties:nil];
}

第三步：测试验证

{
  "event" : "$AppClick",
  "time" : 1648892963385,
  "propeerties" : {
  "$model" : "x86_64",
  "$manufacturer" : "Apple",
  "$element_type" : "UIImageView",
  "$lib_version" : "1.0.0",
  "$os" : "iOS",
  "$app_version" : "1.0",
  "$screen_name" : "ViewController",
  "$os_version" : "15.2",
  "$lib" : "iOS"
  }
}

2.2 UILongPressGestureRecognizer 全埋点
​对于 UILongPressGestureRecognizer 来说，其实现逻辑与 UITapGestureRecognizer 基本上是相同的。