iOS 如何为 UIKit 属性增加钩子方法

www.huijinchan.com 2024-10-14

最近在做一个用于实现夜间模式的开源框架, 需监听 UIKit 中的属性, 而这个监听的通知者就是 UIKit 实例本身, 当我最开始想要做的时候, 我感觉这个东西实在太简单了, 不过之后…

##KVO

我想到的第一个解决方案是使用 KVO 来解决. KVO 是一个很好的方式来为已有的属性添加观察者.

###继承 or 分类?

但是因为要实现的夜间模式要在工程中引入, 而不是使一个已经完成大半的项目重新继承所有的 UIKit 类, 所以使用分类的方式而不是继承的方式引入夜间模式, 而且大部分开源的框架都是以分类的形式来引入以减少使用者的工作量.

由于在分类中无法调用 init 系列方法来为实例增加观察者, 而且让用户自己在 viewContrller 中手动添加观察者对于一个轻量级的框架是难以忍受的, 所以我放弃了 KVO 这个解决方案(因为使用 KVO 就要使用继承).

##Runtime

而第二个解决方案就是使用 objc/runtime 中方法调剂来实现的, 我们在运行时动态替换原有的属性的 setter 的实现, 换成我们自己实现的添加钩子的 setter 方法.

为什么要这么做呢, 因为我们并不清楚系统底层是怎么实现 setter 方法的, 所以重写一个 setter 方法可能会有意想不到的事情发生.

在最开始直接覆写 setter 方法的时候, 因为在分类中无法访问属性例如:

Objective-C

self.backgroundColor

而使用别的办法没有达到想要的效果(动态为分类添加属性覆写 setter 和 getter), 每次为属性backgroundColor 都不会使颜色正确的渲染, 所以我就放弃了, 最终选择 runtime 中的方法调剂实现这一功能.

我直接展示一下方法调剂的代码:

Objective-C

static dispatch_once_t onceToken;              
dispatch_once(&onceToken, ^{                                               
    Class class = [self class];                                           
    SEL originalSelector = @selector(#origin#);
    SEL swizzledSelector = @selector(#swizzle#);

    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);
    }
});

这段代码来自于 NSHipster, 实现还是很清楚的, 我们只需要在 #origin# 和 #swizzle# 处填上需要交换的选择子就可以了.

找对了方法, 接下来的工作就很简单了, 我们需要在哪里加入方法调剂的代码呢, 我的建议是在 load 方法中, 因为这个方法只会在程序的运行中执行一次, 不会导致线程之类的问题.

Objective-C

+ (void)load {
	// Here is your method swizzling code.
}

- (void)hook_setTextColor:(UIColor *)textColor {
	NSLog(@"Before");
	[self hook_setTextColor:textColor];
    NSLog(@"After");
}

有人看到这里可能会有疑问: 方法调用自己是否会导致无限递归?. 其实并不会, 因为我们在运行时交换了方法的实现.

在方法的实现交换之后: