MTHawkeye 是 iOS 下的調試優化輔助工具集，旨在幫助 iOS 開發者提升開發效率、輔助優化性能體驗。

在產品開發周期內，引入 MTHawkeye 來幫助你更快地發現、查找、分析、定位、解決問題：

• 開發階段，側重于開發調試輔助，及時偵測問題，并在必要時提示開發者及時處理
• 測試階段，側重于根據測試場景，收集盡可能多的數據，用于自動化測試分析報告
• 線上階段，側重補充傳統 APM 組件缺失，但自身業務需要收集的一些性能數據

MTHawkeye 內置了一些常用的性能偵測相關插件，也引入并改進了 FLEX 作為調試輔助的一個插件，應用接入 MTHawkeye 時可自定義增改自己需要的插件。

以下為一些內置插件的 demo 演示圖，分別用于查看主線程耗時方法，查看 App 內存分配詳情，查看網絡請求詳情記錄。更多插件及說明見后文。

????

0x00 功能簡介

MTHawkeye 簡單可分為上中下三層，除了最下面的基礎層外，中間為UI 基礎層，最上層的各個插件內部根據不同場景做了職責拆分，應用可根據自己的需要接入。整體結構如下：

基礎功能

基礎層主要提供了插件管理能力，存儲能力和一些基礎工具類。?UI基礎層?則提供了開發、測試階段使用的界面交互框架，包含了懸浮窗、主界面框架和設置面板，插件可以集成到其中。

內置的可選插件

內置的插件根據關注點分成了?Memory,?TimeConsuming,?Energy,?Network,?Graphics,?Storage,?Utility?幾個類別。

Memory

#?LivingObjectSniffer

LivingObjectSniffer?主要用于跟蹤觀察 ViewController 直接或間接持有的對象，以及自定義 View 對象，偵測他們是否異常存活，比如內存泄露、未及時釋放或者不必要的內存緩存。

在開發、測試階段，偵測到的異常情況可以以浮窗警告、Toast 的形式提示開發、測試人員。自動化測試時也可以直接提取記錄的存活對象做進一步的分析判斷。

#?Allocations

Allocations?類同于 Instrument 的 Allocations 功能，跟蹤應用實際分配的內存詳情，在應用內存使用異常（異常上升、OOM 退出）時可以通過記錄的內存使用詳情數據，來排查內存使用問題。

TimeConsuming

#?UITimeProfiler

UITimeProfiler?用于輔助主線程耗時任務的優化。

數據采集部分主要包含 VC Life Trace 和 ObjC CallTrace 兩個組件。VC Life Trace 用于跟蹤 ViewController 打開各個階段的具體時間點，ObjC CallTrace在開啟后，則可跟蹤耗時大于指定閾值的 Objective-C 方法。

界面層部分將兩部分的數據合并展示，便于開發者更便捷的找出關注流程的耗時信息。示例圖如前文的動圖，更詳細的說明見插件說明文檔。

自動化測試、線上階段接入后，無需埋點或插入其他代碼，即可持續的跟蹤啟動耗時、頁面打開耗時和其他關鍵流程耗時。

#?ANRTrace

ANRTrace?用于捕獲卡頓事件，同時采樣卡頓發生時的主線程調用棧。

#?FPSTrace

FPSTrace?用于跟蹤界面 FPS 以及 OpenGL 刷新繪制 FPS，并在浮窗上顯示當前值。

Energy

#?CPUTrace

CPUTrace?用于跟蹤 CPU 持續高使用率，同時記錄高使用率期間主要調用了哪些方法。

#?BackgroundTask Trace

BackgoundTask trace插件將跟蹤UIBackgroundTaskIdentifier的開始/結束，在嘗試查找崩潰0xbada5e47的原因時將很有用。 （直接參見使用代碼）

Network

#?NetworkMonitor

NetworkMonitor?監聽記錄 App 內 HTTP(S) 網絡請求的各個階段耗時，并提供內置的記錄查看界面，便于開發者排查優化網絡問題。

1. 繼承 FLEX 的網絡請求記錄，過濾搜索裸機價。同時優化了監聽初始化邏輯，大幅減少對啟動時間的影響
2. 針對 iOS 9 后的 NSURLSession 的請求，增加記錄 URLSessionTaskMetrics 方便查看請求各個階段的時間
3. 基于 URLSessionTaskMetrics 增加類似 Chrome 網絡調試的 waterfall 視圖，方便查看網絡請求的隊列和并發情況
4. 增加重復網絡請求的偵測
5. 增強搜索欄，支持多條件搜索（域名篩選、重復請求、url 過濾、status 過濾）
6. 記錄展示完整的網絡請求記錄（增加 request headers, request body, response body 記錄）

#?NetworkInspect

NetworkInspect?插件基于 Network Monitor，根據記錄的網絡請求實際情況，偵測是否有可改進優化的項，上層可以自定義自己的規則。

Graphics

#?OpenGLTrace

OpengGLTrace?用于跟蹤 OpenGL 資源內存占用情況，輔助發現 OpenGL API 錯誤調用、異常參數傳遞。

Storage

#?DirectoryWatcher

DirectoryWatcher?主要用于沙盒文件夾的大小跟蹤，便于開發測試過程中發現異常的文件管理問題。同時也集成了 FLEX 的沙盒文件查看。

Utility

#?FLEX

MTHawkeye 插件擴展支持了沙盒文件的 AirDrop 功能。

桌面擴展

如果需要將插件擴展到桌面端，如在桌面上查看處理插件收集到的信息，可基于各插件提供的接口獲取數據，然后橋接到第三方桌面端提供的協議。如

• Facebook Flipper
• Woodpecker

0x01 接入

開發階段接入

首先，以 pod 的形式，在項目 podfile 文件中加入 MTHawkeye 引用：

  #< Only used during Debug
  #< Since the podfile dependency doesn't support environment configuration, 
  #< the dependent pods also need to be explicitly configured as Debug.
  
  def hawkeye
    pod 'MTHawkeye', :configurations => 'Debug'

    pod 'FLEX', :configurations => ['Debug']
    pod 'FBRetainCycleDetector', :configurations => ['Debug']
    pod 'fishhook', :configurations => ['Debug']
    pod 'CocoaLumberjack', 
    '3.6.0', :configurations => ['Debug'] # CocoaLumberjack is optional, change to `MTHawkeye/DefaultPluginsWithoutLog` if don't need.
    # pod 'MTGLDebug', :configurations => ['Debug'] # MTGLDebug is exclude by default, change `MTHawkeye` to `MTHawkeye/DefaultPlugins` to include.

    pod 'MTAppenderFile', :configurations => ['Debug']
  end

  target "YourProject" do
    hawkeye

    # ...
  end

注意：CocoaLumberjack這個依賴庫需要使用<~3.6.0版本。 然后，在應用啟動時開啟 MTHawkeye 服務。可以使用默認集成的所有插件，或者選擇自己需要的插件啟動。

A: 快速集成默認的所有插件:

#ifdef DEBUG
  #import <MTHawkeye/MTRunHawkeyeInOneLine.h>
#endif

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
#ifdef DEBUG
  [MTRunHawkeyeInOneLine start];
#endif
  // ...
}

B: 選擇需要的插件、插入外部新的插件:

測試、線上階段接入

測試階段時可能有特殊的需求，而線上階段可能不需要保留界面部分的代碼。這個時候你可以根據工程的需要創建一個新的?podspec, 在 podspec 里引入在測試、線上階段要引入的 MTHawkeye subspec, 然后在 podfile 內引入

  pod 'YourOnlineHawkeye', :podspec => 'xxx/yourOwnHawkeyeOnline.podspec', :configurations => 'Release'

然后在初始化內根據自己的需要加載插件，配置插件是否啟動（默認不啟動），如

#ifdef Release
  [MTHawkeyeUserDefaults shared].allocationsTraceOn = YES; // 根據需要開啟插件、配置插件

  [[MTHawkeyeClient shared]
    setPluginsSetupHandler:^(NSMutableArray<id> *_Nonnull plugins) {
      [plugins addObject:[MTHAllocationsHawkeyeAdaptor new]];

      // add your additional plugins here.
    }
    pluginsCleanHandler:^(NSMutableArray<id> *_Nonnull plugins) {

    }];

  [[MTHawkeyeClient shared] startServer];
#endif

0x02 交互說明

基礎操作說明：

• 懸浮窗
  • 展示、隱藏懸浮窗：使用三指長按兩秒手勢或者三指左滑手勢
  • 顯示、隱藏懸浮窗插件：進入設置界面，進入 Floating Window，顯隱插件
• 進入主面板：點擊浮窗直接查看最近一次查看的面板
• 設置界面：進入主面板，點擊標題呼出模塊切換界面，點擊右上角?Setting?進入設置界面

各插件的界面交互文檔：詳見上文鏈接

0x03 開發自己的插件

如果有一個模塊在開發過程中需要避開很多坑，或者開發過程中調試/優化相關的日志代碼很多，可以考慮編寫一個調試輔助組件，然后基于 Hawkeye 基礎框架 API，可將這個組件接入到 Hawkeye 框架中使用，以便統一交互和接口。

如果你關注的性能指標在自動化測試時無法持續跟蹤，考慮編寫一個性能分析插件用于抓取性能數據。

詳見：MTHawkeye 插件開發說明文檔