需求情境
專案要做使用者行為分析,需要在頁面切換與互動時向統計系統回報事件。問題是:專案裡有幾十個 ViewController,一個一個手動加程式碼既不現實,後續維護也是災難。本文記錄用 Runtime 的 Method Swizzling 來解決這個問題的完整思路。
方案一:透過類別繼承
繼承是物件導向中最常見的手段。多數工程都會有一個 BaseViewController,所有頁面繼承它,公共方法與屬性寫在父類中即可被子類共用。這也是統一全站視圖控制器樣式的主要途徑。
方案二:Category + Runtime Hook
Hook 的最大好處是「零程式碼侵入」:不必修改任何既有檔案,只要把一個分類拖進工程就全域生效。透過 swizzling 把系統方法與自訂方法交換,就能在原有流程中插入自己的邏輯。
兩案對比
繼承方案更精準。需要統計的頁面本來就繼承自這個父類,而 UINavigationController、系統的 UIAlertController 等不會被誤算進統計資料。
Hook 方案的弱點正好在這裡:我們 hook 的是 viewDidLoad / viewDidAppear:,而這些方法每個控制器都會呼叫,因此系統內建的容器型控制器也會被掃進來,產生不該有的資料。
但考虑到這套統計系統未來可能被公司其他專案複用,零侵入的價值大於精準度的小幅損失,因此最終選擇 Hook 方案,誤算的問題則用過濾機制補救。
一、建立分類並實作 swizzling
+ (void)load {
[super load];
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
// 需要開啟頁面統計時,把下面這行取消註解
__gbh_tracer_swizzleMethod([self class], @selector(viewDidAppear:), @selector(__gbh_tracer_viewDidAppear:));
});
}
這裡呼叫的是一個 C 函式,實作如下(標準寫法,網路上也有現成的開源庫可用):
void __gbh_tracer_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);
}
}
回到第一段程式碼:viewDidAppear: 是被 hook 的目標,__gbh_tracer_viewDidAppear: 是我們自己的實作。
二、在替換方法中上報,並過濾掉不該統計的控制器
- (void)__gbh_tracer_viewDidAppear:(BOOL)animated {
// 方法已交換,這裡呼叫的其實是原本的 viewDidAppear:
[self __gbh_tracer_viewDidAppear:animated];
// 不允許上報的容器型控制器
NSArray *filter = @[@"UINavigationController", @"UITabBarController"];
NSString *className = NSStringFromClass(self.class);
if ([filter containsObject:className]) return;
// 只統計有標題的頁面
if ([self.title isKindOfClass:[NSString class]] && self.title.length > 0) {
// 在這裡發送統計事件
}
}
這裡有兩道判斷:一是黑名單,二是要求 title 非空。基本能過濾掉絕大部分噪音,若還有特定頁面需要排除,繼續往黑名單裡加即可。
三、App 啟動事件用通知更合適
需求還要求在啟動時發一次 init 事件。這裡其實不必 hook,系統現成的 UIApplicationDidFinishLaunchingNotification 就夠用:
@implementation UIApplication (GBHTracer)
+ (void)load {
[super load];
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(__gbh_tracer_applicationDidFinishLaunching:)
name:UIApplicationDidFinishLaunchingNotification
object:nil];
});
}
+ (void)__gbh_tracer_applicationDidFinishLaunching:(NSNotification *)noti {
// 啟動時的處理
}
@end
幾點實務上的提醒
第一,+load 在 App 啟動時執行,這裡面適合只做方法交換這類輕量工作,任何耗時或 I/O 操作都會拖慢啟動速度。
第二,swizzling 一定要用 dispatch_once 保護,並且要在 +load 而非 +initialize 中執行,才能避免多執行緒下的競爭與重複交換。
第三,hook 全域方法終究是「借道」,它會讓除錯時的呼叫堆疊變得不直觀。如果團隊成員對此不熟悉,務必在程式碼中寫清註解,說明為什麼要交換以及交換後的實際行為。
第四,涉及使用者行為的統計資料屬於隱私範疇,上報前應確認已符合相關規範並取得使用者同意,這點在實際落地時比技術實作更關鍵。