InspectiveC API完全手册：watchObject到enableCompleteLogging的12个核心方法

【免费下载链接】InspectiveCobjc_msgSend hook for debugging/inspection purposes.项目地址: https://gitcode.com/gh_mirrors/in/InspectiveC

InspectiveC是一款强大的Objective-C消息调试工具，通过hook objc_msgSend实现对iOS应用运行时的深度监控。本文将系统介绍从InspectiveC_watchObject到InspectiveC_enableCompleteLogging的12个核心API方法，帮助开发者快速掌握这个调试神器的使用技巧。

一、对象监控基础：watchObject与unwatchObject

1. InspectiveC_watchObject

功能：监控指定对象的所有方法调用
定义：void InspectiveC_watchObject(id obj);
使用场景：需要跟踪特定实例的完整生命周期时使用，对象销毁时会自动取消监控。

2. InspectiveC_unwatchObject

功能：取消对指定对象的监控
定义：void InspectiveC_unwatchObject(id obj);
注意事项：虽然对象接收dealloc消息时会自动取消监控，但手动取消可以释放资源并避免不必要的日志输出。

二、精准方法监控：selector级别的控制

3. InspectiveC_watchSelectorOnObject

功能：监控指定对象的特定方法
定义：void InspectiveC_watchSelectorOnObject(id obj, SEL _cmd);
示例：监控UIViewController实例的viewDidLoad方法调用。

4. InspectiveC_unwatchSelectorOnObject

功能：取消对指定对象特定方法的监控
定义：void InspectiveC_unwatchSelectorOnObject(id obj, SEL _cmd);
最佳实践：在不需要继续监控时及时调用，防止日志冗余。

三、类级监控：批量实例跟踪

5. InspectiveC_watchInstancesOfClass

功能：监控指定类的所有实例（不含子类）
定义：void InspectiveC_watchInstancesOfClass(Class clazz);
适用场景：需要分析某类所有实例行为时使用，如跟踪所有UIButton的点击事件。

6. InspectiveC_unwatchInstancesOfClass

功能：取消对指定类实例的监控
定义：void InspectiveC_unwatchInstancesOfClass(Class clazz);
性能提示：对频繁创建的类取消监控可显著提升运行效率。

7. InspectiveC_watchSelectorOnInstancesOfClass

功能：监控指定类所有实例的特定方法
定义：void InspectiveC_watchSelectorOnInstancesOfClass(Class clazz, SEL _cmd);
应用案例：监控所有UITableViewCell的setSelected:方法调用。

8. InspectiveC_unwatchSelectorOnInstancesOfClass

功能：取消对指定类实例特定方法的监控
定义：void InspectiveC_unwatchSelectorOnInstancesOfClass(Class clazz, SEL _cmd);

四、全局方法监控：跨对象跟踪

9. InspectiveC_watchSelector

功能：监控全局范围内的特定方法
定义：void InspectiveC_watchSelector(SEL _cmd);
使用技巧：可用于跟踪系统方法在整个应用中的调用情况，如-[NSObject description]。

10. InspectiveC_unwatchSelector

功能：取消全局方法监控
定义：void InspectiveC_unwatchSelector(SEL _cmd);

五、日志控制：灵活管理输出

11. InspectiveC_enableLogging

功能：启用当前线程的日志记录
定义：void InspectiveC_enableLogging();
配合使用：通常与监控方法结合使用，开始记录感兴趣的事件。

12. InspectiveC_disableLogging

功能：禁用当前线程的日志记录
定义：void InspectiveC_disableLogging();

13. InspectiveC_enableCompleteLogging

功能：启用当前线程的完整日志模式
定义：void InspectiveC_enableCompleteLogging();
特点：记录所有消息发送，适合深度调试但会产生大量日志。

14. InspectiveC_disableCompleteLogging

功能：禁用当前线程的完整日志模式
定义：void InspectiveC_disableCompleteLogging();

15. InspectiveC_flushLogFile

功能：刷新当前线程的日志文件
定义：void InspectiveC_flushLogFile();
使用建议：在关键操作节点调用，确保日志及时写入文件。

六、高级配置：InspectiveC_setMaximumRelativeLoggingDepth

功能：设置日志记录的最大深度
定义：void InspectiveC_setMaximumRelativeLoggingDepth(int depth);
参数说明：depth为整数，控制方法调用链的记录深度，值越大记录越详细。

七、快速上手：简单使用示例

要开始使用InspectiveC，首先需要克隆仓库：

git clone https://gitcode.com/gh_mirrors/in/InspectiveC

以下是一个基本的使用示例，监控UIViewController的viewDidAppear:方法：

// 引入头文件 #include "InspectiveC.h" // 在合适的位置调用监控方法 InspectiveC_watchSelectorOnInstancesOfClass([UIViewController class], @selector(viewDidAppear:)); InspectiveC_enableLogging();

八、API方法速查表

通过灵活组合使用这些API，开发者可以精准捕获iOS应用运行时的各种方法调用，极大提升调试效率和问题定位能力。所有API定义均可在InspectiveC.h文件中查看完整声明。

【免费下载链接】InspectiveCobjc_msgSend hook for debugging/inspection purposes.项目地址: https://gitcode.com/gh_mirrors/in/InspectiveC