当前位置：首页 > news >正文

SwiftTrace面向切面编程：为非final类添加方法前后钩子

news 2026/7/10 18:26:22

SwiftTrace面向切面编程：为非final类添加方法前后钩子

【免费下载链接】SwiftTraceTrace Swift and Objective-C method invocations项目地址: https://gitcode.com/gh_mirrors/sw/SwiftTrace

SwiftTrace是一个强大的Swift和Objective-C方法调用追踪工具，它提供了面向切面编程（AOP）的能力，让你能够为非final类的方法添加前后钩子。这个工具特别适合调试、性能监控和运行时方法拦截等场景。😊

什么是SwiftTrace面向切面编程？

面向切面编程是一种编程范式，允许开发者在不修改原有代码的情况下，为方法添加额外的行为。SwiftTrace通过修改类的虚函数表（vtable），为非final类的方法注入自定义逻辑，实现方法调用前后的拦截功能。

核心功能：方法前后钩子

SwiftTrace的核心功能之一就是为方法添加前后钩子。通过addAspect方法，你可以为特定方法注册进入（onEntry）和退出（onExit）时的回调闭包：

SwiftTrace.addAspect( aClass: TestClass.self, methodName: "SwiftTwaceApp.TestClass.x() -> ()", onEntry: { (_, _) in print("方法开始执行") }, onExit: { (_, _) in print("方法执行结束") } )

这个简单的代码片段会在TestClass.x()方法执行前后分别打印日志，让你轻松监控方法的调用时机。

安装与配置指南

使用Swift Package Manager安装

在你的Package.swift文件中添加依赖：

dependencies: [ .package(url: "https://gitcode.com/gh_mirrors/sw/SwiftTrace", from: "1.0.0") ]

使用CocoaPods安装

在Podfile中添加：

pod 'SwiftTrace'

快速开始配置

在AppDelegate的didFinishLaunchingWithOptions方法中初始化：

import SwiftTrace func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { // 追踪主应用包的所有类 SwiftTrace.traceBundle(containing: type(of: self)) return true }

实战应用场景

性能监控与调试

SwiftTrace非常适合用于性能监控。你可以追踪耗时方法，找出性能瓶颈：

var startTime: Date? SwiftTrace.addAspect( aClass: NetworkManager.self, methodName: "fetchData() -> Data", onEntry: { (_, _) in startTime = Date() print("开始网络请求") }, onExit: { (_, _) in let duration = Date().timeIntervalSince(startTime ?? Date()) print("网络请求耗时: \(duration)秒") } )

参数验证与修改

你还可以在方法执行前验证或修改参数：

SwiftTrace.addAspect( aClass: UserService.self, methodName: "updateUser(id: Int, name: String) -> Bool", onEntry: { (swizzle, stack) in // 获取参数数组，第0个是self let args = swizzle.arguments if let userId = args[1] as? Int, userId <= 0 { print("错误：用户ID必须大于0") } // 修改参数值 stack.intArg2 = 999 // 修改第二个参数 } )

错误处理与日志记录

在方法退出时处理错误和记录日志：

SwiftTrace.addAspect( aClass: DatabaseManager.self, methodName: "saveData(_: Data) throws -> Bool", onExit: { (swizzle, stack) in // 检查是否抛出错误 if let error = swizzle.rebind(&stack.thrownError, to: NSError.self).pointee { print("保存数据时发生错误: \(error.localizedDescription)") // 可以取消错误抛出并设置返回值 stack.thrownError = nil stack.setReturn(value: false) } } )

高级功能详解

修改返回值

在退出钩子中，你可以修改方法的返回值：

SwiftTrace.addAspect( aClass: CacheManager.self, methodName: "getCachedValue(key: String) -> String?", onExit: { (_, stack) in // 如果返回nil，设置默认值 if stack.returnValue == nil { stack.setReturn(value: "默认值") } } )

批量方法追踪

SwiftTrace支持批量追踪类的方法：

// 追踪UIKit中的所有UI开头的类 SwiftTrace.traceClasses(matchingPattern: "^UI") // 追踪特定实例的所有方法 let myViewController = MyViewController() SwiftTrace.trace(anInstance: myViewController)

方法过滤配置

你可以通过正则表达式过滤要追踪的方法：

// 只追踪包含"Test"的方法 SwiftTrace.methodInclusionPattern = "Test" // 排除初始化方法和getter/setter SwiftTrace.methodExclusionPattern = "init|getter|setter|" + SwiftTrace.defaultMethodExclusions