在移動應(yīng)用開發(fā)中，數(shù)據(jù)埋點(diǎn)是了解用戶行為、優(yōu)化產(chǎn)品體驗的重要手段。傳統(tǒng)的埋點(diǎn)方案需要在每個事件觸發(fā)點(diǎn)手動添加代碼，不僅工作量大，還容易遺漏。本文將介紹一種基于AOP（面向切面編程）的無侵入式埋點(diǎn)方案，讓你的應(yīng)用自動追蹤用戶行為。

?? 目錄

• 什么是無侵入式埋點(diǎn)
• AOP埋點(diǎn)的技術(shù)原理
• 完整實現(xiàn)方案
  • 頁面瀏覽追蹤
  • 按鈕點(diǎn)擊追蹤
  • 表格行點(diǎn)擊追蹤
• 核心代碼解析
• 最佳實踐與注意事項
• 總結(jié)

?? 什么是無侵入式埋點(diǎn)

傳統(tǒng)埋點(diǎn)方案的痛點(diǎn)

在傳統(tǒng)的埋點(diǎn)方案中，我們通常需要這樣做：

// ? 傳統(tǒng)方式：需要在每個地方手動埋點(diǎn)
- (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    
    // 手動埋點(diǎn)
    [Analytics trackPage:@"UserCenterViewController"];
}

- (void)loginButtonClicked:(UIButton *)sender {
    // 業(yè)務(wù)邏輯
    [self performLogin];
    
    // 手動埋點(diǎn)
    [Analytics trackEvent:@"login_button_click"];
}

存在的問題：

1. ? 代碼侵入性強(qiáng) - 業(yè)務(wù)代碼與埋點(diǎn)代碼耦合
2. ? 維護(hù)成本高 - 每個頁面、每個按鈕都要手動添加
3. ? 容易遺漏 - 新增功能時容易忘記埋點(diǎn)
4. ? 難以統(tǒng)一 - 不同開發(fā)者埋點(diǎn)方式不一致
5. ? 后期修改困難 - 改變埋點(diǎn)規(guī)則需要修改大量代碼

無侵入式埋點(diǎn)的優(yōu)勢

// ? AOP方式：完全不需要手動埋點(diǎn)
- (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    // 只關(guān)注業(yè)務(wù)邏輯，埋點(diǎn)自動完成
}

- (void)loginButtonClicked:(UIButton *)sender {
    // 只關(guān)注業(yè)務(wù)邏輯，埋點(diǎn)自動完成
    [self performLogin];
}

優(yōu)勢明顯：

1. ? 零侵入 - 業(yè)務(wù)代碼保持純凈
2. ? 全覆蓋 - 自動追蹤所有頁面和點(diǎn)擊事件
3. ? 易維護(hù) - 埋點(diǎn)邏輯集中管理
4. ? 高擴(kuò)展 - 添加新的追蹤類型非常簡單
5. ? 統(tǒng)一規(guī)范 - 所有埋點(diǎn)遵循統(tǒng)一標(biāo)準(zhǔn)

?? AOP埋點(diǎn)的技術(shù)原理

什么是AOP

AOP（Aspect Oriented Programming，面向切面編程） 是一種編程思想，可以在不修改原有代碼的情況下，動態(tài)地添加新功能。

在iOS中，我們通過 Method Swizzling 技術(shù)實現(xiàn)AOP：

// Method Swizzling 核心原理
void swizzleMethod(Class class, SEL originalSelector, SEL swizzledSelector) {
    Method originalMethod = class_getInstanceMethod(class, originalSelector);
    Method swizzledMethod = class_getInstanceMethod(class, swizzledSelector);
    
    // 嘗試添加原始方法
    BOOL didAddMethod = class_addMethod(class, 
                                       originalSelector, 
                                       method_getImplementation(swizzledMethod), 
                                       method_getTypeEncoding(swizzledMethod));
    
    if (didAddMethod) {
        // 如果成功添加，說明原來沒有實現(xiàn)，替換方法
        class_replaceMethod(class, 
                           swizzledSelector, 
                           method_getImplementation(originalMethod), 
                           method_getTypeEncoding(originalMethod));
    } else {
        // 如果添加失敗，說明已有實現(xiàn)，直接交換
        method_exchangeImplementations(originalMethod, swizzledMethod);
    }
}

工作流程

[用戶操作] → [觸發(fā)系統(tǒng)方法] → [被Swizzle的方法] → [執(zhí)行埋點(diǎn)邏輯] → [調(diào)用原始方法] → [業(yè)務(wù)邏輯]

?? 完整實現(xiàn)方案

架構(gòu)設(shè)計

Trace System
├── TraceHandler.h/m          # 統(tǒng)一的埋點(diǎn)處理器
├── UIViewControllerTraceTool # 追蹤工具管理器
├── Category Extensions
│   ├── UIViewController+TracePage    # 頁面瀏覽追蹤
│   ├── UIButton+Trace               # 按鈕點(diǎn)擊追蹤
│   ├── UITableView+Trace           # 表格點(diǎn)擊追蹤
│   ├── UICollectionView+Trace      # 集合視圖追蹤
│   └── UITapGestureRecognizer+Trace # 手勢追蹤

?? 一、頁面瀏覽追蹤

實現(xiàn)思路

通過Swizzle UIViewController 的 viewDidAppear: 方法，自動追蹤所有頁面的進(jìn)入和停留時長。

核心代碼

1. UIViewController+TracePage.h

#import <UIKit/UIKit.h>

@interface UIViewController (TracePage)

// 用于存儲需要上報的自定義參數(shù)
@property (nonatomic, strong) NSDictionary *analyticsParams;

@end

2. UIViewController+TracePage.m

#import "UIViewController+TracePage.h"
#import <objc/runtime.h>
#import "UIViewControllerTraceTool.h"
#import "TraceHandler.h"

@implementation UIViewController (TracePage)

// 在類加載時自動執(zhí)行Method Swizzling
+ (void)load {
    swizzleMethod([self class], 
                 @selector(viewDidAppear:), 
                 @selector(swizzled_viewDidAppear:));
}

// 交換后的方法
- (void)swizzled_viewDidAppear:(BOOL)animated {
    // ?? 注意：這里調(diào)用的實際是原始的viewDidAppear:
    [self swizzled_viewDidAppear:animated];
    
    // 執(zhí)行埋點(diǎn)邏輯
    [self handleViewDidAppear:self animated:animated];
}

// Method Swizzling 輔助函數(shù)
void swizzleMethod(Class class, SEL originalSelector, SEL swizzledSelector) {
    Method originalMethod = class_getInstanceMethod(class, originalSelector);
    Method swizzledMethod = class_getInstanceMethod(class, swizzledSelector);
    
    BOOL didAddMethod = class_addMethod(class, 
                                       originalSelector, 
                                       method_getImplementation(swizzledMethod), 
                                       method_getTypeEncoding(swizzledMethod));
    
    if (didAddMethod) {
        class_replaceMethod(class, 
                           swizzledSelector, 
                           method_getImplementation(originalMethod), 
                           method_getTypeEncoding(originalMethod));
    } else {
        method_exchangeImplementations(originalMethod, swizzledMethod);
    }
}

@end

3. 頁面追蹤處理邏輯

- (void)handleViewDidAppear:(UIViewController *)viewController animated:(BOOL)animated {
    
    // 過濾系統(tǒng)控制器和容器控制器
    if ([viewController isKindOfClass:[UITabBarController class]] ||
        [viewController isKindOfClass:[UINavigationController class]] ||
        [viewController isMemberOfClass:NSClassFromString(@"UICompatibilityInputViewController")]) {
        return;
    }
    
    NSTimeInterval stayDuration = 0;
    
    // 1. 計算上一個頁面的停留時長
    if ([UIViewControllerTraceTool sharedTracker].previousViewController && 
        [UIViewControllerTraceTool sharedTracker].previousViewController != viewController) {
        
        stayDuration = [[NSDate date] timeIntervalSinceDate:
                       [UIViewControllerTraceTool sharedTracker].previousEnterTime];
        
        [UIViewControllerTraceTool sharedTracker].lastEnterTime = 
            [[UIViewControllerTraceTool sharedTracker].previousEnterTime copy];
    }
    
    // 2. 更新當(dāng)前頁面記錄
    [UIViewControllerTraceTool sharedTracker].previousViewController = viewController;
    [UIViewControllerTraceTool sharedTracker].previousEnterTime = [NSDate date];
    
    // 3. 獲取頁面信息
    NSString *pageName = NSStringFromClass([viewController class]);
    NSString *pageTitle = viewController.title ?: @"無標(biāo)題";
    
    NSDictionary *currentPageInfo = @{
        @"page_name": pageName,
        @"page_title": pageTitle,
        @"enter_time": [UIViewControllerTraceTool sharedTracker].previousEnterTime,
        @"leave_time": [NSDate date],
        @"stay_duration": [NSString stringWithFormat:@"%.0f", stayDuration * 1000] // 毫秒
    };
    
    // 4. 上報頁面進(jìn)入事件
    [self reportEvent:@"page_enter" pageInfo:currentPageInfo];
    
    // 5. 更新上一個頁面信息
    [UIViewControllerTraceTool sharedTracker].lastPageInfo = currentPageInfo;
}

4. 數(shù)據(jù)上報

- (void)reportEvent:(NSString *)eventType pageInfo:(NSDictionary *)pageInfo {
    
    NSMutableDictionary *params = [NSMutableDictionary dictionaryWithDictionary:@{
        @"event_type": eventType,
        @"to_page": pageInfo[@"page_name"],
        @"to_page_title": pageInfo[@"page_title"]
    }];
    
    // 添加停留時長和時間戳
    [params addEntriesFromDictionary:@{
        @"from_page_stay_duration": pageInfo[@"stay_duration"],
        @"from_page_leave_time": [self stringFromDate:pageInfo[@"leave_time"]],
        @"enter_time": [self stringFromDate:pageInfo[@"enter_time"]]
    }];
    
    // 添加上一頁信息（頁面路徑追蹤）
    if ([UIViewControllerTraceTool sharedTracker].lastPageInfo) {
        params[@"from_page"] = [UIViewControllerTraceTool sharedTracker].lastPageInfo[@"page_name"];
        params[@"from_page_title"] = [UIViewControllerTraceTool sharedTracker].lastPageInfo[@"page_title"];
    }
    
    //這里也可以添加設(shè)備和應(yīng)用信息
    
    
    // 打印日志（開發(fā)環(huán)境）
    NSLog(@"?? 上報頁面事件: %@", params);
    
    // 上報到服務(wù)器
    [self sendDataToServer:params];
}

效果展示

{
  "event_type": "page__enter",
  "to_page": "UserCenterController",
  "to_page_title": "個人中心",
  "from_page": "HomeController",
  "from_page_title": "首頁",
  "from_page_stay_duration": "15200",  // 毫秒
  "enter_time": "2025-11-10 14:30:25.123",
}

?? 二、按鈕點(diǎn)擊追蹤

實現(xiàn)思路

通過Swizzle UIButton 的 sendAction:to:forEvent: 方法，自動追蹤所有按鈕點(diǎn)擊事件。

核心代碼

1. UIButton+Trace.m

#import "UIButton+Trace.h"
#import <objc/runtime.h>
#import "UIViewControllerTraceTool.h"

@implementation UIButton (Trace)

+ (void)load {
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        [self swizzleSendActionMethod];
    });
}

+ (void)swizzleSendActionMethod {
    Class class = [self class];
    
    SEL originalSelector = @selector(sendAction:to:forEvent:);
    SEL swizzledSelector = @selector(tracking_sendAction:to:forEvent:);
    
    Method originalMethod = class_getInstanceMethod(class, originalSelector);
    Method swizzledMethod = class_getInstanceMethod(class, swizzledSelector);
    
    if (class_addMethod(class, 
                       originalSelector, 
                       method_getImplementation(swizzledMethod), 
                       method_getTypeEncoding(swizzledMethod))) {
        class_replaceMethod(class, 
                           swizzledSelector, 
                           method_getImplementation(originalMethod), 
                           method_getTypeEncoding(originalMethod));
    } else {
        method_exchangeImplementations(originalMethod, swizzledMethod);
    }
}

- (void)tracking_sendAction:(SEL)action to:(id)target forEvent:(UIEvent *)event {
    // 先調(diào)用原始實現(xiàn)（執(zhí)行業(yè)務(wù)邏輯）
    [self tracking_sendAction:action to:target forEvent:event];
    
    // 獲取按鈕信息
    NSString *actionString = NSStringFromSelector(action);
    NSString *targetClass = NSStringFromClass([target class]);
    NSString *buttonTitle = self.currentTitle ?: @"無標(biāo)題";
    NSInteger buttonTag = self.tag;
    
    // 如果按鈕沒有文字，嘗試獲取圖片名稱
    if ([buttonTitle isEqualToString:@"無標(biāo)題"] || buttonTitle.length == 0) {
        UIImage *buttonImage = [self imageForState:UIControlStateNormal];
        NSString *imageName = [buttonImage.imageAsset valueForKey:@"assetName"];
        if (imageName.length > 0) {
            buttonTitle = imageName;
        }
    }
    
    // 獲取按鈕所在的ViewController
    NSString *className = NSStringFromClass([target class]);
    
    // 生成事件key（用于去重）
    NSString *eventKey = [NSString stringWithFormat:@"%@_%@_click", className, buttonTitle];
    
    // 上報點(diǎn)擊事件
    [self reportButtonClickEvent:eventKey button:self target:target];
    
    // 開發(fā)環(huán)境日志
    NSLog(@"?? Button clicked - Action: %@, Target: %@, Title: %@, Tag: %ld",
          actionString, targetClass, buttonTitle, (long)buttonTag);
}

@end

2. 點(diǎn)擊事件上報

- (void)reportButtonClickEvent:(NSString *)eventKey 
                        button:(UIButton *)button 
                        target:(id)target {
    
    // 防抖：500毫秒內(nèi)不重復(fù)上報
    static NSMutableDictionary *lastClickTimes;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        lastClickTimes = [NSMutableDictionary dictionary];
    });
    
    NSTimeInterval now = [[NSDate date] timeIntervalSince1970];
    NSTimeInterval lastClick = [lastClickTimes[eventKey] doubleValue];
    if (now - lastClick < 0.5) {
        return;
    }
    lastClickTimes[eventKey] = @(now);
    
    // 準(zhǔn)備上報數(shù)據(jù)
    NSMutableDictionary *params = [NSMutableDictionary dictionary];
    
    // 基本事件信息
    params[@"event_type"] = @"view_click";
    params[@"timestamp"] = [self currentTimestamp];
    
    // 按鈕信息
    UIImage *buttonImage = [button imageForState:UIControlStateNormal];
    NSString *imageName = [buttonImage.imageAsset valueForKey:@"assetName"] ?: @"無圖片";
    
    params[@"button_tag"] = @(button.tag);
    params[@"view_des"] = button.currentTitle ?: imageName;
    params[@"view_class"] = @"UIButton";
    
    // 所在頁面信息
    params[@"page_class"] = NSStringFromClass([target class]);
    
    UIViewController *vc = [self findViewControllerForView:button];
    if (vc) {
        params[@"page_title"] = vc.title ?: @"無標(biāo)題";
    }
    
    // 添加設(shè)備信息
    
    // 打印日志
    NSLog(@"?? 上報按鈕點(diǎn)擊: %@", params);
    
    // 上報到服務(wù)器
    [self sendDataToServer:params];
}

// 查找按鈕所在的ViewController
- (UIViewController *)findViewControllerForView:(UIView *)view {
    UIResponder *responder = view;
    while ((responder = [responder nextResponder])) {
        if ([responder isKindOfClass:[UIViewController class]]) {
            return (UIViewController *)responder;
        }
    }
    return nil;
}

- (NSString *)currentTimestamp {
    NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
    formatter.dateFormat = @"yyyy-MM-dd HH:mm:ss.SSS";
    return [formatter stringFromDate:[NSDate date]];
}

效果展示

{
  "event_type": "view_click",
  "view_class": "UIButton",
  "view_des": "登錄",
  "button_tag": 100,
  "page_class": "LoginController",
  "page_title": "登錄頁面",
  "timestamp": "2025-11-10 14:30:25.123",
}

?? 三、表格行點(diǎn)擊追蹤

實現(xiàn)思路

通過Swizzle UITableView 的 setDelegate: 方法，再動態(tài)替換代理對象的 tableView:didSelectRowAtIndexPath: 方法實現(xiàn)。

核心代碼

1. UITableView+Trace.m

#import "UITableView+Trace.h"
#import <objc/runtime.h>
#import "UIViewControllerTraceTool.h"

@implementation UITableView (Trace)

+ (void)load {
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        [self swizzleSetDelegateMethod];
    });
}

+ (void)swizzleSetDelegateMethod {
    Class class = [self class];
    
    SEL originalSelector = @selector(setDelegate:);
    SEL swizzledSelector = @selector(tracking_setDelegate:);
    
    Method originalMethod = class_getInstanceMethod(class, originalSelector);
    Method swizzledMethod = class_getInstanceMethod(class, swizzledSelector);
    
    if (class_addMethod(class, 
                       originalSelector, 
                       method_getImplementation(swizzledMethod), 
                       method_getTypeEncoding(swizzledMethod))) {
        class_replaceMethod(class, 
                           swizzledSelector, 
                           method_getImplementation(originalMethod), 
                           method_getTypeEncoding(originalMethod));
    } else {
        method_exchangeImplementations(originalMethod, swizzledMethod);
    }
}

- (void)tracking_setDelegate:(id<UITableViewDelegate>)delegate {
    // 先調(diào)用原始實現(xiàn)
    [self tracking_setDelegate:delegate];
    
    // 檢查代理是否響應(yīng) didSelectRowAtIndexPath: 方法
    if (![delegate respondsToSelector:@selector(tableView:didSelectRowAtIndexPath:)]) {
        return;
    }
    
    Class delegateClass = [delegate class];
    SEL originalSelector = @selector(tableView:didSelectRowAtIndexPath:);
    
    // 獲取原始方法
    Method originalMethod = class_getInstanceMethod(delegateClass, originalSelector);
    if (!originalMethod) {
        return;
    }
    
    // 獲取原始實現(xiàn)
    IMP originalIMP = method_getImplementation(originalMethod);
    
    // 定義新的實現(xiàn)塊
    void (^swizzledBlock)(id, UITableView *, NSIndexPath *) = 
        ^(id _self, UITableView *tableView, NSIndexPath *indexPath) {
        
        // 調(diào)用原始實現(xiàn)（執(zhí)行業(yè)務(wù)邏輯）
        ((void(*)(id, SEL, UITableView*, NSIndexPath*))originalIMP)
            (_self, originalSelector, tableView, indexPath);
        
        // 上報邏輯
        NSLog(@"?? TableView did select row at section: %ld, row: %ld", 
              (long)indexPath.section, (long)indexPath.row);
        
        // 獲取UITableView所在類名
        NSString *className = NSStringFromClass([delegate class]);
        
        // 生成事件key
        NSString *eventKey = [NSString stringWithFormat:@"%@_section_%ld_row_%ld", 
                             className, (long)indexPath.section, (long)indexPath.row];
        
        // 上報表格行點(diǎn)擊事件
        [self reportTableViewClickEvent:eventKey
                              tableView:tableView
                              indexPath:indexPath
                               delegate:delegate];
    };
    
    // 創(chuàng)建新的IMP
    IMP swizzledIMP = imp_implementationWithBlock(swizzledBlock);
    
    // 替換實現(xiàn)
    method_setImplementation(originalMethod, swizzledIMP);
}

@end

2. 表格點(diǎn)擊事件上報

- (void)reportTableViewClickEvent:(NSString *)eventKey 
                        tableView:(UITableView *)tableView
                        indexPath:(NSIndexPath *)indexPath
                         delegate:(id)delegate {
    
    // 防抖
    static NSMutableDictionary *lastClickTimes;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        lastClickTimes = [NSMutableDictionary dictionary];
    });
    
    NSTimeInterval now = [[NSDate date] timeIntervalSince1970];
    NSTimeInterval lastClick = [lastClickTimes[eventKey] doubleValue];
    if (now - lastClick < 0.5) {
        return;
    }
    lastClickTimes[eventKey] = @(now);
    
    // 準(zhǔn)備上報數(shù)據(jù)
    NSMutableDictionary *params = [NSMutableDictionary dictionary];
    
    // 基本事件信息
    params[@"event_type"] = @"tableview_click";
    params[@"timestamp"] = [self currentTimestamp];
    
    // 表格信息
    params[@"view_class"] = @"UITableView";
    params[@"section"] = @(indexPath.section);
    params[@"row"] = @(indexPath.row);
    
    // 嘗試獲取Cell信息
    UITableViewCell *cell = [tableView cellForRowAtIndexPath:indexPath];
    if (cell) {
        params[@"cell_class"] = NSStringFromClass([cell class]);
        if (cell.textLabel.text) {
            params[@"cell_text"] = cell.textLabel.text;
        }
    }
    
    // 所在頁面信息
    params[@"page_class"] = NSStringFromClass([delegate class]);
    
    UIViewController *vc = [self findViewControllerForView:tableView];
    if (vc) {
        params[@"page_title"] = vc.title ?: @"無標(biāo)題";
    }
    
    // 添加設(shè)備信息
    
    // 打印日志
    NSLog(@"?? 上報表格點(diǎn)擊: %@", params);
    
    // 上報到服務(wù)器
    [self sendDataToServer:params];
}

效果展示

{
  "event_type": "tableview_click",
  "view_class": "UITableView",
  "section": 0,
  "row": 3,
  "cell_class": "UserInfoCell",
  "cell_text": "修改密碼",
  "page_class": "SettingsViewController",
  "page_title": "設(shè)置",
  "timestamp": "2025-11-10 14:30:25.123",
}

??? 四、核心工具類

UIViewControllerTraceTool - 追蹤管理器

// UIViewControllerTraceTool.h
#import <Foundation/Foundation.h>

@interface UIViewControllerTraceTool : NSObject

// 頁面瀏覽路徑棧
@property (nonatomic, strong) NSMutableArray *pagePathStack;

// 上一個頁面信息
@property (nonatomic, strong) NSDictionary *lastPageInfo;

// 曝光開始時間字典
@property (nonatomic, strong) NSMutableDictionary *exposureStartTimes;

// 頁面進(jìn)入時間字典
@property (nonatomic, strong) NSMutableDictionary *pageEnterTimes;

// 上一個ViewController（弱引用）
@property (nonatomic, weak) UIViewController *previousViewController;

// 上一個頁面進(jìn)入時間
@property (nonatomic, strong) NSDate *previousEnterTime;

// 最后進(jìn)入時間
@property (nonatomic, strong) NSDate *lastEnterTime;

// 隨機(jī)數(shù)（用于會話追蹤）
@property (nonatomic, strong) NSString *random;

// 單例方法
+ (instancetype)sharedTracker;

@end

// UIViewControllerTraceTool.m
#import "UIViewControllerTraceTool.h"

@implementation UIViewControllerTraceTool

+ (instancetype)sharedTracker {
    static UIViewControllerTraceTool *instance = nil;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        instance = [[self alloc] init];
        instance.pagePathStack = [NSMutableArray array];
        instance.exposureStartTimes = [NSMutableDictionary dictionary];
        instance.pageEnterTimes = [NSMutableDictionary dictionary];
        
        // 生成會話隨機(jī)數(shù)（用于關(guān)聯(lián)同一次會話的所有事件）
        instance.random = [NSString stringWithFormat:@"%.0f_%d", 
                          [[NSDate date] timeIntervalSince1970] * 1000,
                          arc4random() % 10000];
    });
    return instance;
}

@end

?? 五、數(shù)據(jù)上報實現(xiàn)

統(tǒng)一上報方法

- (void)sendDataToServer:(NSDictionary *)params {
    
    // 組裝完整上報參數(shù)
    NSMutableDictionary *reportParams = [NSMutableDictionary dictionary];
    
    // 數(shù)據(jù)主體
    [reportParams setObject:params.dictionarysToJsons forKey:@"data"];
    
    // 元信息
    NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
    [formatter setDateFormat:@"yyyy-MM-dd HH:mm:ss.SSS"];
    NSString *time = [formatter stringFromDate:[NSDate date]];
    [reportParams setObject:time forKey:@"t"];
    

 
    // 隱私合規(guī)檢查
    if (同意隱私協(xié)議) {
        // 發(fā)送網(wǎng)絡(luò)請求
        [[XXHTTPManager Manager] 
           WithSuccessBlock:^(NSDictionary *dic) {
            NSLog(@"? 埋點(diǎn)上報成功");
        } 
         WithFailurBlock:^(NSError *error) {
            NSLog(@"? 埋點(diǎn)上報失敗: %@", error);
        }];
    }
}

批量上報優(yōu)化

@interface TraceDataBuffer : NSObject

+ (instancetype)sharedBuffer;

// 添加待上報數(shù)據(jù)
- (void)addTraceData:(NSDictionary *)data;

// 立即上報所有數(shù)據(jù)
- (void)flush;

@end

@implementation TraceDataBuffer {
    NSMutableArray *_dataQueue;
    NSTimer *_flushTimer;
}

+ (instancetype)sharedBuffer {
    static TraceDataBuffer *instance = nil;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        instance = [[self alloc] init];
        instance->_dataQueue = [NSMutableArray array];
        
        // 每隔10秒自動上報一次
        instance->_flushTimer = [NSTimer scheduledTimerWithTimeInterval:10.0
                                                                 target:instance
                                                               selector:@selector(flush)
                                                               userInfo:nil
                                                                repeats:YES];
    });
    return instance;
}

- (void)addTraceData:(NSDictionary *)data {
    @synchronized (self) {
        [_dataQueue addObject:data];
        
        // 隊列達(dá)到50條時立即上報
        if (_dataQueue.count >= 50) {
            [self flush];
        }
    }
}

- (void)flush {
    @synchronized (self) {
        if (_dataQueue.count == 0) {
            return;
        }
        
        NSArray *dataToSend = [_dataQueue copy];
        [_dataQueue removeAllObjects];
        
        NSLog(@"?? 批量上報 %ld 條埋點(diǎn)數(shù)據(jù)", (long)dataToSend.count);
        
        // 批量上報到服務(wù)器
        [self sendBatchData:dataToSend];
    }
}

- (void)sendBatchData:(NSArray *)dataArray {
    // 實現(xiàn)批量上報邏輯
    NSDictionary *params = @{
        @"events": dataArray,
        @"count": @(dataArray.count),
        @"timestamp": @([[NSDate date] timeIntervalSince1970])
    };
    
    // 發(fā)送網(wǎng)絡(luò)請求...
}

@end

? 六、性能優(yōu)化

1. 防抖處理

// 防止短時間內(nèi)重復(fù)上報同一事件
- (BOOL)shouldReportEvent:(NSString *)eventKey {
    static NSMutableDictionary *lastReportTimes;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        lastReportTimes = [NSMutableDictionary dictionary];
    });
    
    NSTimeInterval now = [[NSDate date] timeIntervalSince1970];
    NSTimeInterval lastTime = [lastReportTimes[eventKey] doubleValue];
    
    // 500毫秒內(nèi)不重復(fù)上報
    if (now - lastTime < 0.5) {
        return NO;
    }
    
    lastReportTimes[eventKey] = @(now);
    return YES;
}

2. 異步處理

- (void)reportEvent:(NSDictionary *)eventData {
    // 在后臺隊列處理埋點(diǎn)邏輯，避免阻塞主線程
    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_LOW, 0), ^{
        // 數(shù)據(jù)處理
        NSMutableDictionary *params = [self processEventData:eventData];
        
        // 添加到上報隊列
        [[TraceDataBuffer sharedBuffer] addTraceData:params];
    });
}

3. 內(nèi)存優(yōu)化

- (void)dealloc {
    // 移除所有Hook
    [[NSNotificationCenter defaultCenter] removeObserver:self];
    
    // 清理緩存
    [self.pagePathStack removeAllObjects];
    [self.exposureStartTimes removeAllObjects];
    [self.pageEnterTimes removeAllObjects];
}

?? 七、最佳實踐

1. 合理過濾頁面

// 過濾不需要追蹤的系統(tǒng)頁面
- (BOOL)shouldTrackViewController:(UIViewController *)viewController {
    // 過濾系統(tǒng)容器控制器
    if ([viewController isKindOfClass:[UITabBarController class]] ||
        [viewController isKindOfClass:[UINavigationController class]]) {
        return NO;
    }
    
    // 過濾系統(tǒng)鍵盤相關(guān)控制器
    NSString *className = NSStringFromClass([viewController class]);
    NSArray *blackList = @[
        @"UICompatibilityInputViewController",
        @"UISystemKeyboardDockController",
        @"UIPredictionViewController",
        @"UISystemInputAssistantViewController"
    ];
    
    if ([blackList containsObject:className]) {
        return NO;
    }
    
    return YES;
}

2. 隱私合規(guī)

// 只在用戶同意隱私協(xié)議后才上報數(shù)據(jù)

    // 隱私合規(guī)檢查
    if (同意隱私協(xié)議) {
        [self reportEvent:eventData];
    }

// 敏感信息脫敏
- (NSString *)desensitizePhoneNumber:(NSString *)phone {
    if (phone.length == 11) {
        return [NSString stringWithFormat:@"%@****%@",
                [phone substringToIndex:3],
                [phone substringFromIndex:7]];
    }
    return phone;
}

3. 開發(fā)環(huán)境調(diào)試

#ifdef DEBUG
    #define TraceLog(format, ...) NSLog(@"[Trace] " format, ##__VA_ARGS__)
#else
    #define TraceLog(...)
#endif

// 使用
TraceLog(@"頁面進(jìn)入: %@", pageName);

4. 錯誤處理

- (void)swizzled_viewDidAppear:(BOOL)animated {
    @try {
        [self swizzled_viewDidAppear:animated];
        [self handleViewDidAppear:self animated:animated];
    } @catch (NSException *exception) {
        NSLog(@"? Trace異常: %@", exception);
        // 確保不影響正常業(yè)務(wù)邏輯
    }
}

5. 配置化管理

@interface TraceConfig : NSObject

@property (nonatomic, assign) BOOL enablePageTrack;      // 是否啟用頁面追蹤
@property (nonatomic, assign) BOOL enableButtonTrack;    // 是否啟用按鈕追蹤
@property (nonatomic, assign) BOOL enableTableViewTrack; // 是否啟用表格追蹤
@property (nonatomic, assign) NSTimeInterval debounceTime; // 防抖時間
@property (nonatomic, assign) NSInteger batchSize;       // 批量上報數(shù)量
@property (nonatomic, assign) NSTimeInterval flushInterval; // 上報間隔

+ (instancetype)sharedConfig;

@end

?? 八、數(shù)據(jù)分析應(yīng)用

重要說明：本章節(jié)展示的是數(shù)據(jù)分析結(jié)果示例，這些分析指標(biāo)（如跳出率、平均時長等）是在服務(wù)端/數(shù)據(jù)分析平臺計算的，不是iOS端直接上報的字段。

iOS端 vs 服務(wù)端的職責(zé)劃分

// ? iOS端上報的原始數(shù)據(jù)
{
  "event_type": "page_enter",
  "page_name": "ProductDetailViewController",
  "enter_time": "2025-11-10 15:30:25.123",
  "leave_time": "2025-11-10 15:30:55.456",
  "stay_duration": "30333",  // 毫秒
  "from_page": "HomeViewController",
  "to_page": "OrderViewController"
}

// ? iOS端不計算這些（由服務(wù)端計算）
// "bounce_rate"         - 跳出率
// "stay_duration_avg"   - 平均停留
// "conversion_rate"     - 轉(zhuǎn)化率

用戶行為路徑分析

// 追蹤用戶的頁面訪問路徑
HomeViewController → ProductListViewController → ProductDetailViewController → OrderViewController

// 可以分析：
// 1. 哪些頁面是用戶的主要瀏覽路徑
// 2. 哪些頁面是用戶的流失點(diǎn)
// 3. 哪些功能入口的點(diǎn)擊率最高

頁面停留時長分析

注意：以下是服務(wù)端數(shù)據(jù)分析平臺統(tǒng)計后的結(jié)果示例，不是iOS端直接上報的字段。

{
  "page": "ProductDetailViewController",
  "stay_duration_avg": 45000,      // 平均停留45秒（服務(wù)端計算）
  "stay_duration_median": 30000,   // 中位數(shù)30秒（服務(wù)端計算）
  "bounce_rate": 0.25              // 跳出率25%（服務(wù)端計算）
}

跳出率計算公式：

跳出率 = (單頁訪問次數(shù) / 總訪問次數(shù)) × 100%

單頁訪問：用戶進(jìn)入該頁面后，沒有訪問其他頁面就離開了

熱點(diǎn)功能分析

注意：點(diǎn)擊次數(shù)和點(diǎn)擊率是服務(wù)端聚合統(tǒng)計的結(jié)果。

{
  "button_clicks": [
    {"button": "下單按鈕", "clicks": 1250, "rate": 0.35},     // 服務(wù)端統(tǒng)計
    {"button": "收藏按鈕", "clicks": 800, "rate": 0.22},      // 服務(wù)端統(tǒng)計
    {"button": "分享按鈕", "clicks": 450, "rate": 0.12}       // 服務(wù)端統(tǒng)計
  ]
}

iOS端只需上報：

{
  "event_type": "view_click",
  "view_des": "下單按鈕",
  "page_class": "ProductDetailViewController",
  "timestamp": "2025-11-10 15:30:25.123"
}

?? 九、Aspects vs 原生Method Swizzling：沖突與解決

問題背景

在實際項目中，我最初使用了Aspects框架來實現(xiàn)AOP埋點(diǎn)，但很快發(fā)現(xiàn)與友盟統(tǒng)計SDK和Bugly崩潰統(tǒng)計SDK產(chǎn)生了嚴(yán)重沖突，導(dǎo)致某些統(tǒng)計功能失效。經(jīng)過深入分析，我發(fā)現(xiàn)是多個Hook框架對同一方法進(jìn)行Swizzle時產(chǎn)生的沖突。

Aspects框架原理

Aspects 是一個輕量級的AOP框架，它的實現(xiàn)原理如下：

1. 核心機(jī)制

// Aspects的Hook流程
[UIViewController aspect_hookSelector:@selector(viewDidAppear:)
                          withOptions:AspectPositionAfter
                           usingBlock:^(id<AspectInfo> aspectInfo, BOOL animated) {
    // 埋點(diǎn)邏輯
} error:NULL];

內(nèi)部實現(xiàn)步驟：

1. 創(chuàng)建子類 - Aspects會動態(tài)創(chuàng)建目標(biāo)類的子類（通過objc_allocateClassPair）
2. 轉(zhuǎn)發(fā)機(jī)制 - 替換原始方法的IMP為_objc_msgForward（消息轉(zhuǎn)發(fā)）
3. 攔截調(diào)用 - 在forwardInvocation:中攔截方法調(diào)用
4. 執(zhí)行Hook - 按照Before/Instead/After的順序執(zhí)行Hook的block
5. 調(diào)用原方法 - 最后調(diào)用原始的實現(xiàn)

2. Aspects的實現(xiàn)細(xì)節(jié)

// Aspects內(nèi)部實現(xiàn)（簡化版）
+ (id<AspectToken>)aspect_hookSelector:(SEL)selector
                           withOptions:(AspectOptions)options
                            usingBlock:(id)block
                                 error:(NSError **)error {
    
    // 1. 獲取原始方法
    Method targetMethod = class_getInstanceMethod(self, selector);
    IMP originalIMP = method_getImplementation(targetMethod);
    
    // 2. 替換為消息轉(zhuǎn)發(fā)
    class_replaceMethod(self, selector, _objc_msgForward, method_getTypeEncoding(targetMethod));
    
    // 3. 保存原始IMP和Hook信息
    AspectIdentifier *identifier = [[AspectIdentifier alloc] init];
    identifier.selector = selector;
    identifier.block = block;
    identifier.originalIMP = originalIMP;
    
    // 4. 添加到Hook容器
    [aspectContainer addAspect:identifier];
    
    return identifier;
}

// 5. 在forwardInvocation:中執(zhí)行Hook
- (void)__aspects_forwardInvocation:(NSInvocation *)invocation {
    // 獲取所有Hook
    NSArray *beforeAspects = [aspectContainer aspectsForPosition:AspectPositionBefore];
    NSArray *insteadAspects = [aspectContainer aspectsForPosition:AspectPositionInstead];
    NSArray *afterAspects = [aspectContainer aspectsForPosition:AspectPositionAfter];
    
    // Before
    for (AspectIdentifier *aspect in beforeAspects) {
        [aspect invokeWithInfo:info];
    }
    
    // Instead 或 原方法
    if (insteadAspects.count > 0) {
        [insteadAspects.firstObject invokeWithInfo:info];
    } else {
        // 調(diào)用原方法
        [invocation invokeWithTarget:self];
    }
    
    // After
    for (AspectIdentifier *aspect in afterAspects) {
        [aspect invokeWithInfo:info];
    }
}

沖突原因分析

1. 多重Hook導(dǎo)致的問題

當(dāng)友盟、Bugly和你的埋點(diǎn)系統(tǒng)都對同一個方法（如viewDidAppear:）進(jìn)行Hook時，會產(chǎn)生以下問題：

// 原始方法
- (void)viewDidAppear:(BOOL)animated

// 第一次Hook：Bugly統(tǒng)計（使用Method Swizzling）
// IMP: viewDidAppear: → bugly_viewDidAppear:
// bugly_viewDidAppear: 內(nèi)部會調(diào)用原始的 viewDidAppear:

// 第二次Hook：友盟統(tǒng)計（使用Method Swizzling）
// IMP: viewDidAppear: → umeng_viewDidAppear:
// umeng_viewDidAppear: 內(nèi)部會調(diào)用 bugly_viewDidAppear:

// 第三次Hook：你的埋點(diǎn)（使用Aspects）
// IMP: viewDidAppear: → _objc_msgForward (消息轉(zhuǎn)發(fā))
// ? 問題：Aspects把IMP替換成了消息轉(zhuǎn)發(fā)，破壞了之前的Hook鏈

沖突示意圖：

正常的Hook鏈（Method Swizzling）：
viewDidAppear: → umeng_viewDidAppear: → bugly_viewDidAppear: → 原始實現(xiàn)
     ?              ?                    ?                  ?

使用Aspects后（破壞了Hook鏈）：
viewDidAppear: → _objc_msgForward → forwardInvocation: → ? 丟失了umeng和bugly的Hook
     ?

2. 具體沖突表現(xiàn)

// 友盟統(tǒng)計代碼（偽代碼）
+ (void)load {
    [self swizzleMethod:@selector(viewDidAppear:) 
            withSwizzle:@selector(umeng_viewDidAppear:)];
}

- (void)umeng_viewDidAppear:(BOOL)animated {
    // 友盟統(tǒng)計邏輯
    [UMAnalytics trackPageStart:NSStringFromClass([self class])];
    
    // 調(diào)用原方法（實際調(diào)用的是bugly的）
    [self umeng_viewDidAppear:animated];
}

// Bugly統(tǒng)計代碼（偽代碼）
+ (void)load {
    [self swizzleMethod:@selector(viewDidAppear:) 
            withSwizzle:@selector(bugly_viewDidAppear:)];
}

- (void)bugly_viewDidAppear:(BOOL)animated {
    // Bugly統(tǒng)計邏輯
    [Bugly trackViewController:self];
    
    // 調(diào)用原方法
    [self bugly_viewDidAppear:animated];
}

// 你的Aspects代碼
+ (void)load {
    [UIViewController aspect_hookSelector:@selector(viewDidAppear:)
                              withOptions:AspectPositionAfter
                               usingBlock:^(id<AspectInfo> info, BOOL animated) {
        // 你的埋點(diǎn)邏輯
        [self trackPage];
    } error:NULL];
}

// ? 問題：Aspects把viewDidAppear:的IMP改成了_objc_msgForward
// 導(dǎo)致友盟和Bugly的Hook失效！

3. 沖突的根本原因

// Method Swizzling：保持IMP鏈
IMP1 → IMP2 → IMP3 → 原始IMP  ? 可以共存

// Aspects：消息轉(zhuǎn)發(fā)
IMP → _objc_msgForward  ? 丟失之前的所有Hook

解決方案

經(jīng)過實踐，我采用了原生Method Swizzling替代Aspects，完美解決了沖突問題。

方案1：使用原生Method Swizzling（推薦）?????

// UIViewController+TracePage.m

#import "UIViewController+TracePage.h"
#import <objc/runtime.h>

@implementation UIViewController (TracePage)

+ (void)load {
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        [self swizzleMethod];
    });
}

+ (void)swizzleMethod {
    Class class = [self class];
    
    SEL originalSelector = @selector(viewDidAppear:);
    SEL swizzledSelector = @selector(tracking_viewDidAppear:);
    
    Method originalMethod = class_getInstanceMethod(class, originalSelector);
    Method swizzledMethod = class_getInstanceMethod(class, swizzledSelector);
    
    // ? 關(guān)鍵：正確的Swizzle實現(xiàn)
    BOOL didAddMethod = class_addMethod(class,
                                       originalSelector,
                                       method_getImplementation(swizzledMethod),
                                       method_getTypeEncoding(swizzledMethod));
    
    if (didAddMethod) {
        // 原來沒有實現(xiàn)，替換
        class_replaceMethod(class,
                           swizzledSelector,
                           method_getImplementation(originalMethod),
                           method_getTypeEncoding(originalMethod));
    } else {
        // 已有實現(xiàn)，交換IMP
        method_exchangeImplementations(originalMethod, swizzledMethod);
    }
}

// ? Swizzled方法
- (void)tracking_viewDidAppear:(BOOL)animated {
    // 先調(diào)用原方法（實際會調(diào)用鏈中的下一個：友盟/Bugly）
    [self tracking_viewDidAppear:animated];
    
    // 再執(zhí)行自己的埋點(diǎn)邏輯
    [self handlePageTracking];
}

- (void)handlePageTracking {
    // 過濾系統(tǒng)控制器
    if ([self isKindOfClass:[UINavigationController class]] ||
        [self isKindOfClass:[UITabBarController class]]) {
        return;
    }
    
    // 埋點(diǎn)邏輯
    NSString *pageName = NSStringFromClass([self class]);
    NSLog(@"?? 頁面追蹤: %@", pageName);
    
    // 上報數(shù)據(jù)...
}

@end

優(yōu)勢：

• ? 與友盟、Bugly完美共存
• ? 形成完整的調(diào)用鏈
• ? 不依賴第三方框架
• ? 性能更好

調(diào)用鏈?zhǔn)疽?/strong>：

用戶調(diào)用 viewDidAppear:
    ↓
你的 tracking_viewDidAppear:（你的埋點(diǎn)）
    ↓
友盟 umeng_viewDidAppear:（友盟統(tǒng)計）
    ↓
Bugly bugly_viewDidAppear:（Bugly統(tǒng)計）
    ↓
原始 viewDidAppear:（系統(tǒng)實現(xiàn)）

? 所有Hook都能正常執(zhí)行

// 1. 確保你的Hook最先執(zhí)行（在其他SDK之前）
// 修改Podfile，調(diào)整依賴順序
pod 'YourTraceSDK', :path => './YourTraceSDK'  # 最先加載
pod 'UMCAnalytics'
pod 'Bugly'

// 2. 在AppDelegate中手動初始化
- (BOOL)application:(UIApplication *)application 
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    // ?? 順序很重要！先初始化Aspects Hook
    [self setupAspectsTracking];  // 第一步
    
    // 再初始化友盟和Bugly
    [UMConfigure initWithAppkey:@"your_key" channel:@"App Store"];  // 第二步
    [Bugly startWithAppId:@"your_id"];  // 第三步
    
    return YES;
}

// 檢測是否已被Hook
+ (BOOL)isMethodSwizzled:(SEL)selector {
    Method method = class_getInstanceMethod([UIViewController class], selector);
    IMP imp = method_getImplementation(method);
    
    // 檢查IMP是否已經(jīng)不是原始的
    return imp != class_getMethodImplementation([UIViewController class], selector);
}

+ (void)load {
    // 如果已被Hook（友盟/Bugly），使用原生Swizzling
    if ([self isMethodSwizzled:@selector(viewDidAppear:)]) {
        NSLog(@"?? viewDidAppear: 已被Hook，使用原生Method Swizzling");
        [self useNativeSwizzling];
    } else {
        NSLog(@"? viewDidAppear: 未被Hook，可以使用Aspects");
        [self useAspects];
    }
}

// 測試類
@interface HookTestViewController : UIViewController
@end

@implementation HookTestViewController

- (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    NSLog(@"? 原始 viewDidAppear 執(zhí)行");
}

@end

// 測試結(jié)果

// 使用Aspects前：
// 2025-11-10 15:30:25 [友盟] 統(tǒng)計頁面: HookTestViewController ?
// 2025-11-10 15:30:25 [Bugly] 記錄頁面: HookTestViewController ?
// 2025-11-10 15:30:25 ? 原始 viewDidAppear 執(zhí)行

// 使用Aspects后：
// 2025-11-10 15:30:25 [我的埋點(diǎn)] 統(tǒng)計頁面: HookTestViewController ?
// 2025-11-10 15:30:25 ? 原始 viewDidAppear 執(zhí)行
// ? 友盟和Bugly的統(tǒng)計失效了！

// 改用原生Method Swizzling后：
// 2025-11-10 15:30:25 [我的埋點(diǎn)] 統(tǒng)計頁面: HookTestViewController ?
// 2025-11-10 15:30:25 [友盟] 統(tǒng)計頁面: HookTestViewController ?
// 2025-11-10 15:30:25 [Bugly] 記錄頁面: HookTestViewController ?
// 2025-11-10 15:30:25 ? 原始 viewDidAppear 執(zhí)行
// ? 完美！所有統(tǒng)計都正常工作

// ? 推薦做法
@implementation UIViewController (TracePage)

+ (void)load {
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        [self swizzleInstanceMethod:@selector(viewDidAppear:)
                                with:@selector(tracking_viewDidAppear:)];
    });
}

+ (void)swizzleInstanceMethod:(SEL)originalSelector with:(SEL)swizzledSelector {
    Class class = [self class];
    
    Method originalMethod = class_getInstanceMethod(class, originalSelector);
    Method swizzledMethod = class_getInstanceMethod(class, swizzledSelector);
    
    if (!originalMethod || !swizzledMethod) {
        return;
    }
    
    BOOL didAddMethod = class_addMethod(class,
                                       originalSelector,
                                       method_getImplementation(swizzledMethod),
                                       method_getTypeEncoding(swizzledMethod));
    
    if (didAddMethod) {
        class_replaceMethod(class,
                           swizzledSelector,
                           method_getImplementation(originalMethod),
                           method_getTypeEncoding(originalMethod));
    } else {
        method_exchangeImplementations(originalMethod, swizzledMethod);
    }
}

- (void)tracking_viewDidAppear:(BOOL)animated {
    // ?? 注意：這里看起來是遞歸，實際不是
    // 因為方法已經(jīng)交換，這里調(diào)用的是原始方法
    [self tracking_viewDidAppear:animated];
    
    // 執(zhí)行埋點(diǎn)
    [self performPageTracking];
}

@end

// HookManager.h
@interface HookManager : NSObject

+ (void)setupAllHooks;

@end

// HookManager.m
@implementation HookManager

+ (void)setupAllHooks {
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        // 統(tǒng)一在這里管理所有Hook
        [self hookViewController];
        [self hookButton];
        [self hookTableView];
    });
}

+ (void)hookViewController {
    [self swizzleClass:[UIViewController class]
              original:@selector(viewDidAppear:)
             swizzled:@selector(tracking_viewDidAppear:)];
}

+ (void)hookButton {
    [self swizzleClass:[UIButton class]
              original:@selector(sendAction:to:forEvent:)
             swizzled:@selector(tracking_sendAction:to:forEvent:)];
}

// ... 更多Hook

@end

// 在AppDelegate中調(diào)用
- (BOOL)application:(UIApplication *)application 
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    // 在所有SDK初始化之前設(shè)置Hook
    [HookManager setupAllHooks];
    
    return YES;
}

+ (void)swizzleInstanceMethod:(SEL)originalSelector with:(SEL)swizzledSelector {
    Class class = [self class];
    
    Method originalMethod = class_getInstanceMethod(class, originalSelector);
    Method swizzledMethod = class_getInstanceMethod(class, swizzledSelector);
    
    // ? 安全檢查
    if (!originalMethod) {
        NSLog(@"? 原始方法不存在: %@", NSStringFromSelector(originalSelector));
        return;
    }
    
    if (!swizzledMethod) {
        NSLog(@"? Swizzle方法不存在: %@", NSStringFromSelector(swizzledSelector));
        return;
    }
    
    // 檢查是否已經(jīng)Swizzle過
    IMP originalIMP = method_getImplementation(originalMethod);
    IMP swizzledIMP = method_getImplementation(swizzledMethod);
    
    if (originalIMP == swizzledIMP) {
        NSLog(@"?? 方法已被Swizzle: %@", NSStringFromSelector(originalSelector));
        return;
    }
    
    // 執(zhí)行Swizzle
    BOOL didAddMethod = class_addMethod(class,
                                       originalSelector,
                                       method_getImplementation(swizzledMethod),
                                       method_getTypeEncoding(swizzledMethod));
    
    if (didAddMethod) {
        class_replaceMethod(class,
                           swizzledSelector,
                           method_getImplementation(originalMethod),
                           method_getTypeEncoding(originalMethod));
        NSLog(@"? Swizzle成功（添加方法）: %@", NSStringFromSelector(originalSelector));
    } else {
        method_exchangeImplementations(originalMethod, swizzledMethod);
        NSLog(@"? Swizzle成功（交換方法）: %@", NSStringFromSelector(originalSelector));
    }
}

// ? 錯誤：沒有調(diào)用原始方法
- (void)swizzled_viewDidAppear:(BOOL)animated {
    // 只執(zhí)行埋點(diǎn)邏輯，忘記調(diào)用原始方法
    [self handleViewDidAppear:self animated:animated];
}

// ? 正確：先調(diào)用原始方法
- (void)swizzled_viewDidAppear:(BOOL)animated {
    [self swizzled_viewDidAppear:animated]; // 實際調(diào)用的是原始方法
    [self handleViewDidAppear:self animated:animated];
}

// ? 使用@synchronized確保線程安全
- (void)addTraceData:(NSDictionary *)data {
    @synchronized (self) {
        [_dataQueue addObject:data];
    }
}

// ? 錯誤：強(qiáng)引用導(dǎo)致循環(huán)引用
self.pageInfo = @{
    @"viewController": viewController  // 強(qiáng)引用
};

// ? 正確：只保存必要的信息
self.pageInfo = @{
    @"page_name": NSStringFromClass([viewController class])
};

// 建議：
// 1. 異步處理埋點(diǎn)邏輯
// 2. 批量上報數(shù)據(jù)
// 3. 使用防抖避免頻繁上報
// 4. 在低優(yōu)先級隊列處理

Trace/
├── TraceHandler.h/m                 # 統(tǒng)一處理器
├── UIViewControllerTraceTool.h/m    # 追蹤管理器
├── UIViewController+TracePage.h/m   # 頁面追蹤
├── UIButton+Trace.h/m              # 按鈕追蹤
├── UITableView+Trace.h/m           # 表格追蹤
├── UICollectionView+Trace.h/m      # 集合視圖追蹤
└── UITapGestureRecognizer+Trace.h/m # 手勢追蹤