# LivingObjectSniffer
LivingObjectSniffer 主要用于跟踪观察ViewController直接或间接持有的对象，以及自定义View对象，侦测他们是否异常存活，比如内存泄露、未及时释放或者不必要的内存缓存。在开发、测试阶段，侦测到的异常情况可以以浮窗警告、Toast的形式提示开发、测试人员。自动化测试时也可以直接提取记录的存活对象做进一步的分析判断。# Allocations
Allocations 类同于Instrument的Allocations功能，跟踪应用实际分配的内存详情，在应用内存使用异常（异常上升、OOM退出）时可以通过记录的内存使用详情数据，来排查内存使用问题。TimeConsuming# UITimeProfiler
UITimeProfiler 用于辅助主线程耗时任务的优化。数据采集部分主要包含VCLifeTrace和ObjCCallTrace两个组件。VCLifeTrace用于跟踪ViewController打开各个阶段的具体时间点，ObjCCallTrace在开启后，则可跟踪耗时大于指定阈值的Objective-C方法。界面层部分将两部分的数据合并展示，便于开发者更便捷的找出关注流程的耗时信息。示例图如前文的动图，更详细的说明见插件说明文档。自动化测试、线上阶段接入后，无需埋点或插入其他代码，即可持续的跟踪启动耗时、页面打开耗时和其他关键流程耗时。# ANRTrace
ANRTrace 用于捕获卡顿事件，同时采样卡顿发生时的主线程调用栈。# FPSTrace
FPSTrace 用于跟踪界面FPS以及OpenGL刷新绘制FPS，并在浮窗上显示当前值。Energy# CPUTrace
CPUTrace 用于跟踪CPU持续高使用率，同时记录高使用率期间主要调用了哪些方法。# BackgroundTaskTrace
BackgoundTasktrace插件将跟踪UIBackgroundTaskIdentifier的开始/结束，在尝试查找崩溃0xbada5e47的原因时将很有用。（直接参见使用代码）Network# NetworkMonitor
NetworkMonitor 监听记录App内HTTP(S)网络请求的各个阶段耗时，并提供内置的记录查看界面，便于开发者排查优化网络问题。继承FLEX的网络请求记录，过滤搜索裸机价。同时优化了监听初始化逻辑，大幅减少对启动时间的影响针对iOS9后的NSURLSession的请求，增加记录URLSessionTaskMetrics方便查看请求各个阶段的时间基于URLSessionTaskMetrics增加类似Chrome网络调试的waterfall视图，方便查看网络请求的队列和并发情况增加重复网络请求的侦测增强搜索栏，支持多条件搜索（域名筛选、重复请求、url过滤、status过滤）记录展示完整的网络请求记录（增加requestheaders,requestbody,responsebody记录）# NetworkInspect
NetworkInspect 插件基于NetworkMonitor，根据记录的网络请求实际情况，侦测是否有可改进优化的项，上层可以自定义自己的规则。Graphics# OpenGLTrace
OpengGLTrace 用于跟踪OpenGL资源内存占用情况，辅助发现OpenGLAPI错误调用、异常参数传递。Storage# DirectoryWatcher
DirectoryWatcher 主要用于沙盒文件夹的大小跟踪，便于开发测试过程中发现异常的文件管理问题。同时也集成了FLEX的沙盒文件查看。Utility# FLEX
MTHawkeye插件扩展支持了沙盒文件的AirDrop功能。桌面扩展如果需要将插件扩展到桌面端，如在桌面上查看处理插件收集到的信息，可基于各插件提供的接口获取数据，然后桥接到第三方桌面端提供的协议。如FacebookFlipperWoodpecker0x01接入开发阶段接入首先，以pod的形式，在项目podfile文件中加入MTHawkeye引用：#<OnlyusedduringDebug#<Sincethepodfiledependencydoesn'tsupportenvironmentconfiguration,#<thedependentpodsalsoneedtobeexplicitlyconfiguredasDebug.defhawkeyepod'MTHawkeye',:configurations=>'Debug'pod'FLEX',:configurations=>['Debug']pod'FBRetainCycleDetector',:configurations=>['Debug']pod'fishhook',:configurations=>['Debug']pod'CocoaLumberjack','3.6.0',:configurations=>['Debug']#CocoaLumberjackisoptional,changeto`MTHawkeye/DefaultPluginsWithoutLog`ifdon'tneed.#pod'MTGLDebug',:configurations=>['Debug']#MTGLDebugisexcludebydefault,change`MTHawkeye`to`MTHawkeye/DefaultPlugins`toinclude.pod'MTAppenderFile',:configurations=>['Debug']endtarget"YourProject"dohawkeye#...end注意：CocoaLumberjack这个依赖库需要使用<~3.6.0版本。然后，在应用启动时开启MTHawkeye服务。可以使用默认集成的所有插件，或者选择自己需要的插件启动。A:快速集成默认的所有插件:#ifdefDEBUG#import<MTHawkeye/MTRunHawkeyeInOneLine.h>#endif-(BOOL)application:(UIApplication*)applicationdidFinishLaunchingWithOptions:(NSDictionary*)launchOptions{#ifdefDEBUG[MTRunHawkeyeInOneLinestart];#endif//...}B:选择需要的插件、插入外部新的插件:
测试、线上阶段接入测试阶段时可能有特殊的需求，而线上阶段可能不需要保留界面部分的代码。这个时候你可以根据工程的需要创建一个新的 podspec,在podspec里引入在测试、线上阶段要引入的MTHawkeyesubspec,然后在podfile内引入pod'YourOnlineHawkeye',:podspec=>'xxx/yourOwnHawkeyeOnline.podspec',:configurations=>'Release'然后在初始化内根据自己的需要加载插件，配置插件是否启动（默认不启动），如#ifdefRelease[MTHawkeyeUserDefaultsshared].allocationsTraceOn=YES;//根据需要开启插件、配置插件[[MTHawkeyeClientshared]setPluginsSetupHandler:^(NSMutableArray<id<MTHawkeyePlugin>>*_Nonnullplugins){[pluginsaddObject:[MTHAllocationsHawkeyeAdaptornew]];//addyouradditionalpluginshere.}pluginsCleanHandler:^(NSMutableArray<id<MTHawkeyePlugin>>*_Nonnullplugins){}];[[MTHawkeyeClientshared]startServer];#endif0x02交互说明基础操作说明：悬浮窗展示、隐藏悬浮窗：使用三指长按两秒手势或者三指左滑手势显示、隐藏悬浮窗插件：进入设置界面，进入FloatingWindow，显隐插件进入主面板：点击浮窗直接查看最近一次查看的面板设置界面：进入主面板，点击标题呼出模块切换界面，点击右上角 Setting 进入设置界面各插件的界面交互文档：详见上文链接0x03开发自己的插件如果有一个模块在开发过程中需要避开很多坑，或者开发过程中调试/优化相关的日志代码很多，可以考虑编写一个调试辅助组件，然后基于Hawkeye基础框架API，可将这个组件接入到Hawkeye框架中使用，以便统一交互和接口。如果你关注的性能指标在自动化测试时无法持续跟踪，考虑编写一个性能分析插件用于抓取性能数据。详见：MTHawkeye插件开发说明文档
评论