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 基本上是相同的。