LLDebugTool - 便捷的IOS調(diào)試工具(支持組件化)

image

LLDebugTool是一款針對開發(fā)者和測試者的調(diào)試工具，它可以幫助你在非Xcode的情況下，進行數(shù)據(jù)分析和操作。

為您的下一個項目選擇LLDebugTool，或者遷移到您現(xiàn)有的項目中——您會為此感到驚喜！

screenGif.gif

最近更新 (1.2.0)

支持組件化。

LLDebugTool 現(xiàn)在已經(jīng)支持組件化了。現(xiàn)在你可以集成某一個或者多個模塊到你自己的Debug 工具里。你可以直接使用每個模塊內(nèi)包含的視圖控制器，或者只調(diào)用Function文件夾下的功能，然后自己搭建UI。

如何使用組件化，具體請看Wiki使用組件化或者添加 LLDebugTool 到你的項目中。

更多的修改內(nèi)容可以查看Version 1.2.0 Project。

新增

  • 增加 LLRoute，用于解決組件間的相互引用。當相關(guān)組件存在時， LLRoute 會調(diào)用相關(guān)的方法，否則什么都不會做。

更新

  • 更新文件夾目錄。現(xiàn)在整個項目是根據(jù)組件來分類的，在每個組件文件夾下，又分為Function 和 UserInterface。

  • 修改組件間的相互引用的文件，改為由Route處理。

  • 更新了 NSURLSessionConfiguration.m ，hook了 protocolClasses 這個方法。

添加 LLDebugTool 到你的項目中

CocoaPods

CocoaPods 是集成LLDebugTool的首選方式。

Objective - C
  1. 添加 pod 'LLDebugTool' , '~> 1.0.0' 到你的Podfile里。如果只想在Debug模式下使用，則添加pod 'LLDebugTool' , '~> 1.0.0' ,:configurations => ['Debug'] 到你的Podfile里，詳細的配置方式可以查看Wiki/如何僅在Debug環(huán)境中使用。如果你想要指定某個版本，可以類似這樣使用 pod 'LLDebugTool' , '1.1.7' ,:configurations => ['Debug']。
  2. 終端輸入pod install來進行集成。搜索不到LLDebugTool或者搜不到最新版本時，可先運行pod repo update，再執(zhí)行pod install。
  3. 在你需要使用LLDebugTool的文件里添加#import "LLDebug.h"，或者直接在pch文件中添加#import "LLDebug.h"。
Swift
  1. 添加 pod 'LLDebugToolSwift' , '~> 1.0.0' 到你的Podfile里。如果只想在Debug模式下使用，則添加pod 'LLDebugToolSwift' , '~> 1.0.0' ,:configurations => ['Debug'] 到你的Podfile里，詳細的配置方式可以查看Wiki/如何僅在Debug環(huán)境中使用。如果你想要指定某個版本，可以類似這樣使用 pod 'LLDebugToolSwift' , '1.1.7' ,:configurations => ['Debug']。
  2. 必須在Podfile中添加 use_frameworks! 。
  3. 終端輸入pod install來進行集成。搜索不到LLDebugToolSwift或者搜不到最新版本時，可先運行pod repo update，再執(zhí)行pod install。
  4. 在你需要使用LLDebugTool的文件里添加import LLDebugToolSwift。

Carthage

Carthage 是一個分散的依賴管理器，它構(gòu)建您的依賴并為您提供framework框架。

Objective - C

  1. 要使用Carthage將LLDebugTool集成到Xcode項目中，請在Cartfile中指定它:

    github "LLDebugTool"

  2. 運行 carthage 來構(gòu)建框架，并將構(gòu)建的LLDebugTool.framework拖到Xcode項目中。

Swift

  1. 要使用Carthage將LLDebugToolSwift集成到Xcode項目中，請在Cartfile中指定它:

    github "LLDebugToolSwift"

  2. 運行 carthage 來構(gòu)建框架，并將構(gòu)建的LLDebugToolSwift.framework拖到Xcode項目中。

源文件

您可以直接將名為LLDebugTool文件夾的源文件添加到項目中。

Objective - C
  1. 下載最新的代碼版本或?qū)⒋鎯熳鳛間it子模塊添加到您的git跟蹤項目中。
  2. 在Xcode中打開項目，然后拖拽名為“LLDebugTool”的源文件夾到你的項目中。當提示Choose options for adding these files時，務(wù)必勾選Copy items if needed這項。
  3. 集成FMDB到項目中，F(xiàn)MDB是一個圍繞SQLite的Objective-C包裝器開源庫。
  4. 在你需要使用LLDebugTool的文件里添加#import "LLDebug.h"，或者直接在pch文件中添加#import "LLDebug.h"。
Swift
  1. 下載最新的Objective-C代碼版本或?qū)⒋鎯熳鳛間it子模塊添加到您的git跟蹤項目中。
  2. 下載最新的Swift擴展代碼版本或?qū)⒋鎯熳鳛間it子模塊添加到您的git跟蹤項目中。
  3. 在Xcode中打開項目，然后拖拽名為“LLDebugTool”和“LLDebugToolSwift”的源文件夾到你的項目中。當提示Choose options for adding these files時，務(wù)必勾選Copy items if needed這項。
  4. 集成FMDB到項目中，F(xiàn)MDB是一個圍繞SQLite的Objective-C包裝器開源庫。
  5. 在你需要使用LLDebugTool的文件里添加import LLDebugToolSwift。

如何使用

啟動

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

如果你想自定義一些參數(shù)，你需要在調(diào)用"startWorking"前配置這些參數(shù)。更詳細的配置信息請看LLConfig.h。

  • 快速啟動

In Objective-C

#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;
}

In Swift

import LLDebugToolSwift

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        // ####################### Start LLDebugTool #######################//
        // Use this line to start working.
        LLDebugTool.shared().startWorking()
        
        // Write your project code here.
        
        return true
    }
  • 使用自定義的配置啟動

In Objective-C

#import "AppDelegate.h"
#import "LLDebug.h"

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    //####################### Color Style #######################//
    // Uncomment one of the following lines to change the color configuration.
    // [LLConfig sharedConfig].colorStyle = LLConfigColorStyleSystem;
    // [[LLConfig sharedConfig] configBackgroundColor:[UIColor orangeColor] textColor:[UIColor whiteColor] statusBarStyle:UIStatusBarStyleDefault];
    
    //####################### User Identity #######################//
    // Use this line to tag user. More config please see "LLConfig.h".
    [LLConfig sharedConfig].userIdentity = @"Miss L";
    
    //####################### Window Style #######################//
    // Uncomment one of the following lines to change the window style.
    // [LLConfig sharedConfig].windowStyle = LLConfigWindowNetBar;

    //####################### Features #######################//
    // Uncomment this line to change the available features.
    // [LLConfig sharedConfig].availables = LLConfigAvailableNoneAppInfo;
    
    // ####################### Start LLDebugTool #######################//
    // Use this line to start working.
    [[LLDebugTool sharedTool] startWorking];
    
    return YES;
}

In Swift

import LLDebugToolSwift

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        
        //####################### Color Style #######################//
        // Uncomment one of the following lines to change the color configuration.
        // LLConfig.shared().colorStyle = .system
        // LLConfig.shared().configBackgroundColor(.orange, textColor: .white, statusBarStyle: .default)
        
        //####################### User Identity #######################//
        // Use this line to tag user. More config please see "LLConfig.h".
        LLConfig.shared().userIdentity = "Miss L";
        
        //####################### Window Style #######################//
        // Uncomment one of the following lines to change the window style.
        // LLConfig.shared().windowStyle = .netBar
        
        //####################### Features #######################//
        // Uncomment this line to change the available features.
        // LLConfig.shared().availables = .noneAppInfo
        
        // ####################### Start LLDebugTool #######################//
        // Use this line to start working.
        LLDebugTool.shared().startWorking()
        
        return true
    }

日志

打印和保存一個日志。 更多的log宏信息查看LLLogHelper.h。

  • 保存日志

In Objective-C

#import "LLDebug.h"

- (void)testNormalLog {
    // Insert an LLog where you want to print.
    LLog(@"Message you want to save or print.");
}

In Swift

import LLDebugToolSwift

    func testNormalLog() {
        // Insert an LLog where you want to print.
        LLog.log(message: "Message you want to save or print.")
    }
  • Save Log with event and level

In Objective-C

#import "LLDebug.h"

- (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.");
}

In Swift

import LLDebugToolSwift

    func testEventErrorLog() {
        // Insert an LLog_Error_Event where you want to print an event and level log.
        LLog.errorLog(message: "Message you want to save or print.", event: "The event that you want to mark. such as bugA, taskB or processC.")
    }

網(wǎng)絡(luò)請求

你不需要做任何操作，只需要調(diào)用了"startWorking"就可以監(jiān)控大部分的網(wǎng)絡(luò)請求，包括使用NSURLSession，NSURLConnection和AFNetworking。如果你發(fā)現(xiàn)某些情況下無法監(jiān)控網(wǎng)絡(luò)請求，請打開一個issue來告訴我。

崩潰

你不需要做任何操作，只需要調(diào)用"startWorking"就可以截獲崩潰，保存崩潰信息、原因和堆棧信息，并且也會同時保存當次網(wǎng)絡(luò)請求和日志信息。

App信息

LLDebugTool會監(jiān)控app的CPU，內(nèi)存和FPS。你可以更便捷的查看app的各種信息。

沙盒

LLDebugTool提供了一個快捷的方式來查看和操作沙盒文件，你可以更輕松的刪除沙盒中的文件/文件夾，或者通過airdrop來分享文件/文件夾。只要是apple支持的文件格式，你可以直接通過LLDebugTool來預(yù)覽。

更多使用

  • 你可以通過查看Wiki，獲得更多幫助。
  • 你可以下載并運行LLDebugToolDemo或LLDebugToolSwiftDemo來發(fā)現(xiàn)LLDebugTool的更多使用方式。Demo是在XCode9.3，ios 11.3，cocoapods 1.5.0下運行的，如果有任何版本兼容問題，請告訴我。

要求

LLDebugTool在支持ios8+，并且需要使用ARC模式。使用到的框架已經(jīng)包含在大多數(shù)Xcode模板中:

  • UIKit

  • Foundation

  • SystemConfiguration

  • Photos

  • malloc

  • mach-o

  • mach

  • QuickLook

  • objc

  • sys

結(jié)構(gòu)

  • LLDebug.h 公用頭文件.

  • LLConfig 配置文件。

    用于自定義顏色、大小、標識和其他信息。如果您想要配置任何東西，您需要關(guān)注這個文件。

  • LLDebugTool 工具文件。

    用于啟動和停止LLDebugTool，你需要看一下"LLDebugTool.h"這個文件。

  • Helper 輔助文件。

    如果你對功能的實現(xiàn)原理不感興趣，那么可以忽略這個文件夾。

    • LLAppHelper 用于監(jiān)視應(yīng)用程序的各種屬性。
    • LLCrashHelper 用于當App發(fā)生崩潰時，收集崩潰信息。
    • LLLogHelper 快速打印和保存日志。
    • LLNetworkHelper 用于監(jiān)視網(wǎng)絡(luò)請求。
    • LLSandboxHelper Sandbox Helper。用于查看和操作沙盒文件。
    • LLStorageManager Storage Helper。用于數(shù)據(jù)存儲和讀取。

  • UserInterface UI文件。

    如果你想要修改、查看或者學(xué)習(xí)UI方面的東西，你可以查看一下這個文件夾。

    • Base 父類文件
    • Categories 類擴展
    • Others 不通用的控件
    • Resources 圖片資源
    • Sections 視圖控制器
    • Tool 工具

聯(lián)系

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

聯(lián)系

更新日志

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

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 179,324評論 25贊 708
  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具（例如配置管理，服務(wù)發(fā)現(xiàn)，斷路器，智...
    卡卡羅2017閱讀 136,695評論 19贊 139
  • 生活需要激情，猶如偶爾小露的童趣，勾搭激情的時候童趣顯的幼稚，但是唯有一點激情才能懂得生活的快樂無比！ 色彩斑斕的...
    顧純熙閱讀 321評論 2贊 1
  • --不需要看到你的眼神，我都可以想象你小小身體里那大自然一般的靜逸、一不小心就可以觸發(fā)的好奇、和影帝都無法去演繹的...
    齋言言閱讀 306評論 0贊 3
  • 頭銜不僅僅是一個稱號，更是一份責(zé)任。官銜越大責(zé)任越大，要求的能力也越大。能否帶領(lǐng)團隊越做越好，是一種自我能力的考驗。
    王榕榕閱讀 160評論 0贊 0

友情鏈接更多精彩內(nèi)容