LLDebugTool - 便捷的IOS除錯工具(Version 1.1.3)

HDB_Li發表於2018-08-17
iOS除錯

 LLDebugTool

LLDebugTool是一款針對開發者和測試者的除錯工具，它可以幫助你在非Xcode的情況下，進行資料分析和操作。

為您的下一個專案選擇LLDebugTool，或者遷移到您現有的專案中——您會為此感到驚喜！

Gif

LLDebugTool - 便捷的IOS除錯工具(Version 1.1.3) LLDebugTool - 便捷的IOS除錯工具(Version 1.1.3)

ScreenShots

LLDebugTool - 便捷的IOS除錯工具(Version 1.1.3) LLDebugTool - 便捷的IOS除錯工具(Version 1.1.3) LLDebugTool - 便捷的IOS除錯工具(Version 1.1.3) LLDebugTool - 便捷的IOS除錯工具(Version 1.1.3) LLDebugTool - 便捷的IOS除錯工具(Version 1.1.3)

最近更新 (1.1.3)

重構資料庫

修復了一些資料庫的問題。 現在他能表現的更加友好，你可以通過Mac上的軟體檢視模型的內容。以後某天，LLLogHelper 會單獨分離出來，成一個可以在release環境使用的埋點工具。

新的版本會將舊版本的資料庫刪除，如果你仍有資料需要使用，請在你不需要的時候再更新。

新增

  • 增加功能測試和UI測試，雖然它現在什麼都沒有。

更新

  • 重構了LLStorageManager確保他能夠在同步/非同步或者主執行緒/子執行緒中正常的工作。
  • DEPRECATED了一些LLStorageManager, LLTool 和 LLAppHelper中的方法，具體內容可以檢視LLStorageManager.h, LLTool.h 和 LLAppHelper.h.
  • 在LLConfig中增加一個列舉值，用來控制LLLogHelper的log方式。

我能用LLDebugTool做什麼?

  • 檢查網路請求或者檢視某些事件的日誌資訊，而不必非在XCode執行下執行。這在解決測試人員的問題上很有用。

  • 更輕鬆的篩選有用的資訊。

  • 更輕鬆的處理偶發的問題。

  • 更輕鬆的分析崩潰原因。

  • 更輕鬆的分享、預覽或刪除沙盒檔案，這在開發階段非常有用。

  • 更輕鬆的觀察App的CPU，記憶體，FPS等資訊。

新增 LLDebugTool 到你的專案中

CocoaPods

CocoaPods 是整合LLDebugTool的首選方式。

  1. 新增 pod 'LLDebugTool' 到你的Podfile裡。如果只想在Debug模式下使用，則新增pod 'LLDebugTool' ,:configurations => ['Debug'] 到你的Podfile裡，詳細的配置方式可以檢視Wiki/如何僅在Debug環境中使用。
  2. 終端輸入pod install來進行整合。搜尋不到LLDebugTool時，可先執行pod repo update，再執行pod install。
  3. 在你需要使用LLDebugTool的檔案裡新增#import "LLDebug.h"，或者直接在pch檔案中新增#import "LLDebug.h"。

Carthage

Carthage 是一個分散的依賴管理器，它構建您的依賴併為您提供framework框架。

  1. 要使用Carthage將LLDebugTool整合到Xcode專案中，請在“Cartfile”中加入這行：
github "LLDebugTool"
複製程式碼
  1. 執行 carthage 來構建框架，並將構建的“LLDebugTool.framework”拖到Xcode專案中。

原始檔

您可以直接將名為LLDebugTool資料夾的原始檔新增到專案中。

  1. 下載最新的程式碼版本或將儲存庫作為git子模組新增到您的git跟蹤專案中。
  2. 在Xcode中開啟專案，然後拖拽名為“LLDebugTool”的原始檔夾到你的專案中。當提示Choose options for adding these files時，務必勾選Copy items if needed這項。
  3. 整合FMDB到專案中，FMDB是一個圍繞SQLite的Objective-C包裝器開源庫。
  4. 在你需要使用LLDebugTool的檔案裡新增#import "LLDebug.h"，或者直接在pch檔案中新增#import "LLDebug.h"。

如何使用

啟動

你需要在"application:(UIApplication * )application didFinishLaunchingWithOptions:(NSDictionary * )launchOptions"中啟動LLDebugTool，否則你可能會丟掉某些資訊。

如果你想自定義一些引數，你需要在呼叫"startWorking"前配置這些引數。更詳細的配置資訊請看LLConfig.h。

  • 快速啟動
#import "AppDelegate.h"
#import "LLDebug.h"

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // The default color configuration is green background and white text color. 

    // Start working.
    [[LLDebugTool sharedTool] startWorking];
    
    // Write your project code here.
    return YES;
}
複製程式碼
  • 使用自定義的配置啟動
#import "AppDelegate.h"
#import "LLDebug.h"

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // The default color configuration is LLConfigColorStyleHack. 
    
    // If you want to use other color configurations, you can use the following line.
    [LLConfig sharedConfig].colorStyle = LLConfigColorStyleSimple;
    
    // If you want to use a custom color configuration, you can use the following line.
    [[LLConfig sharedConfig] configBackgroundColor:[UIColor orangeColor] textColor:[UIColor whiteColor] statusBarStyle:UIStatusBarStyleDefault];
    
    // If you don't want to use color configuration, you can use the following line.
    [LLConfig sharedConfig].useSystemColor = YES;
    
    // Start working.
    [[LLDebugTool sharedTool] startWorking];

    // Write your project code here.
    return YES;
}
複製程式碼

日誌

列印和儲存一個日誌。 更多的log巨集資訊檢視LLLogHelper.h。

  • 儲存日誌
#import "LLDebug.h"

- (void)testNormalLog {
    // Insert an LLog where you want to print.
    LLog(@"Message you want to save or print.");
}
複製程式碼
  • Save Log with event and level
#import "LLDebug.h"

- (void)test
- (void)testEventErrorLog {
    // Insert an LLog_Error_Event where you want to print an event and level log.
    LLog_Error_Event(@"The event that you want to mark. such as bugA, taskB or processC.",@"Message you want to save or print.");
}
複製程式碼

網路請求

你不需要做任何操作，只需要呼叫了"startWorking"就可以監控大部分的網路請求，包括使用NSURLSession，NSURLConnection和AFNetworking。如果你發現某些情況下無法監控網路請求，請開啟一個issue來告訴我。

崩潰

你不需要做任何操作，只需要呼叫"startWorking"就可以截獲崩潰，儲存崩潰資訊、原因和堆疊資訊，並且也會同時儲存當次網路請求和日誌資訊。

App資訊

LLDebugTool會監控app的CPU，記憶體和FPS。你可以更便捷的檢視app的各種資訊。

沙盒

LLDebugTool提供了一個快捷的方式來檢視和操作沙盒檔案，你可以更輕鬆的刪除沙盒中的檔案/資料夾，或者通過airdrop來分享檔案/資料夾。只要是apple支援的檔案格式，你可以直接通過LLDebugTool來預覽。

更多使用

  • 你可以通過檢視Wiki，獲得更多幫助。
  • 你可以下載並執行LLDebugToolDemo來發現LLDebugTool的更多使用方式。Demo是在XCode9.3，ios 11.3，cocoapods 1.5.0下執行的，如果有任何版本相容問題，請告訴我。

要求

LLDebugTool在支援ios8+，並且需要使用ARC模式。使用到的框架已經包含在大多數Xcode模板中:

  • UIKit

  • Foundation

  • SystemConfiguration

  • Photos

  • malloc

  • mach-o

  • mach

  • QuickLook

  • objc

  • sys

結構

  • LLDebug.h 公用標頭檔案.

  • LLConfig 配置檔案。

    用於自定義顏色、大小、標識和其他資訊。如果您想要配置任何東西，您需要關注這個檔案。

  • LLDebugTool 工具檔案。

    用於啟動和停止LLDebugTool，你需要看一下"LLDebugTool.h"這個檔案。

  • Helper 輔助檔案。

    如果你對功能的實現原理不感興趣，那麼可以忽略這個資料夾。

    • LLAppHelper 用於監視應用程式的各種屬性。
    • LLCrashHelper 用於當App發生崩潰時，收集崩潰資訊。
    • LLLogHelper 快速列印和儲存日誌。
    • LLNetworkHelper 用於監視網路請求。
    • LLSandboxHelper Sandbox Helper。用於檢視和操作沙盒檔案。
    • LLStorageManager Storage Helper。用於資料儲存和讀取。

  • UserInterface UI檔案。

    如果你想要修改、檢視或者學習UI方面的東西，你可以檢視一下這個資料夾。

    • Base 父類檔案
    • Categories 類擴充套件
    • Others 不通用的控制元件
    • Resources 圖片資源
    • Sections 檢視控制器
    • Tool 工具

聯絡

  • 如果你需要幫助，開啟一個issue。
  • 如果你想問一個普遍的問題，開啟一個issue。
  • 如果你發現了一個bug，並能提供可靠的複製步驟，開啟一個issue。
  • 如果你有一個功能請求，開啟一個issue。
  • 如果你發現有什麼不對或不喜歡的地方，就開啟一個issue。
  • 如果你有一些好主意或者一些需求，請發郵件(llworkinggroup@qq.com)給我。
  • 如果你想貢獻，提交一個pull request。

聯絡

更新日誌

可以在 CHANGELOG 中找到每個LLDebugTool版本的簡要總結。

相關文章