SwiftHook：iOS中的高效方法钩子库

SwiftHook：iOS中的高效方法钩子库

SwiftHook 是一个专为 iOS 平台设计的安全、简便且性能卓越的动态方法钩子库，完美适配 Swift 与 Objective-C。它基于 iOS 运行时和强大的 libffi 库，提供了灵活而高效率的面向方面编程（AOP）解决方案。

安装指南

使用 CocoaPods

集成 SwiftHook 到您的项目中，您只需在您的 Podfile 中添加以下行：

pod 'EasySwiftHook'

然后，在终端中执行 pod install 来完成安装过程。

项目使用说明

SwiftHook 支持多种使用场景，从简单的实例方法钩子到类方法甚至完全覆盖方法的行为，下面是一些基本用法示例。

实例方法钩子前调用

在指定实例的方法执行之前插入逻辑：

let object = MyObject()
do {
    let token = try hookBefore(object: object, selector: #selector(MyObject.sayHello)) {
        print("你会说你好，对吗？")
    }
    object.sayHello()
    token.cancelHook()
} catch {
    XCTFail()
}

实例方法钩子后调用，并获取参数

执行方法后执行闭包，并传递方法参数：

let object = MyObject()
let token = try hookAfter(object: object, selector: #selector(MyObject.sayHi(_:)), closure: { _, _, name in
    print("很高兴见到你，\(name)")
}) as! Token

object.sayHi(name: "张三")
token.cancelHook()

完全重写方法行为

替换方法的原始实现：

let object = MyObject()
let token = try hookInstead(object: object, selector: #selector(MyObject.sum(left:right:)), closure: { _, _, left, right in
    print("\(left) + \(right) 等于 \($0)")
    return left * right
}) as! Token

let result = object.sum(left: 5, right: 3)
print("\(5) * \(3) 等于 \(result)")
token.cancelHook()

类方法及全局实例方法钩子

应用到类的所有实例或直接对类方法进行钩子处理：

let token = try hookBefore(targetClass: MyObject.self, selector: #selector(MyObject.sayHello())) {
    print("即将打招呼...")
}
MyObject.sayHello()
token.cancelHook()

项目API使用文档

SwiftHook 提供了一系列API来满足不同的钩子需求：

• hookBefore: 在特定实例的方法调用前执行代码。
• hookAfter: 方法执行后调用闭包，并可访问其参数。
• hookInstead: 完全替换方法的执行逻辑。
• hookBefore与hookClassMethodBefore: 分别用于类方法的前调用钩子。

每种钩子方法都接受相应的参数，如目标对象、选择器和自定义闭包，确保了高度的灵活性和控制力。

性能表现

SwiftHook 相较于其他钩子库，如 Aspects，在大多数情况下展现出显著更高的性能，尤其是在处理全实例或特定实例的钩子时。

要求

• 操作系统: 至少支持 iOS 10.0。
• Xcode: 版本11及以上。
• Swift版本: 5.0 及以上。

结论

SwiftHook 通过其简洁的 API 设计、高性能和广泛的支持性，成为了 iOS 开发者实施动态方法拦截与增强的理想工具。无论是在进行调试、测试还是实现高级功能如日志记录、权限校验等场景下，SwiftHook 都能提供强大而可靠的支撑。