LLDebugTool - 便捷的IOS调试工具(支持Swift)

LLDebugTool 是一款针对开发者和测试者的调试工具，它可以帮助你在非Xcode的情况下，进行数据分析和操作。

LLDebugToolSwift 是针对 LLDebugTool 的Swift扩展，它提供了LLDebugTool的Swift接口，LLDebugToolSwift会和LLDebugTool同步更新。

如果你的项目是一个Objective-C项目，你可以使用 LLDebugTool ，如果你的额项目是一个Swift项目或者包含Swift文件，你可以使用 LLDebugToolSwift 。

为您的下一个项目选择LLDebugTool，或者迁移到您现有的项目中——您会为此感到惊喜！

Gif

ScreenShots

最近更新 (1.1.7)

支持Swift，更多Swift的用法可以查看 LLDebugToolSwift 。

LLDebugToolSwift 是一个 LLDebugTool 的swift组件，它提供了一个 LLog 的swift类，用于在swift中使用log。

更多的修改内容可以查看 Version 1.1.7 Project 。

新增

• 增加 LLog.swift ，用于解决 LLDebugToolMacros 无法在swift中使用。

更新

• 更新 LLCrashHelper ，现在 LLDebugTool 可以正确的截获signal信息。

我能用LLDebugTool做什么?

• 检查网络请求或者查看某些事件的日志信息，而不必非在XCode运行下运行。这在解决测试人员的问题上很有用。

• 更轻松的筛选有用的信息。

• 更轻松的处理偶发的问题。

• 更轻松的分析崩溃原因。

• 更轻松的分享、预览或删除沙盒文件，这在开发阶段非常有用。

• 更轻松的观察App的CPU，内存，FPS等信息。

添加 LLDebugTool 到你的项目中

CocoaPods

CocoaPods 是集成 LLDebugTool 的首选方式。

Objective - C

1. 添加 pod 'LLDebugTool' , '~> 1.0.0' 到你的Podfile里。如果只想在Debug模式下使用，则添加 pod 'LLDebugTool' , '~> 1.0.0' ,:configurations => ['Debug'] 到你的Podfile里，详细的配置方式可以查看 Wiki/如何仅在Debug环境中使用 。如果你想要指定某个版本，可以类似这样使用 pod 'LLDebugTool' , '1.1.7' ,:configurations => ['Debug'] 。
2. 终端输入 pod install 来进行集成。搜索不到 LLDebugTool 或者搜不到最新版本时，可先运行 pod repo update ，再执行 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环境中使用 。如果你想要指定某个版本，可以类似这样使用 pod 'LLDebugToolSwift' , '1.1.7' ,:configurations => ['Debug'] 。
2. 必须在Podfile中添加 use_frameworks! 。
3. 终端输入 pod install 来进行集成。搜索不到 LLDebugToolSwift 或者搜不到最新版本时，可先运行 pod repo update ，再执行 pod install 。
4. 在你需要使用LLDebugTool的文件里添加 import LLDebugToolSwift 。

Carthage

Carthage 是一个分散的依赖管理器，它构建您的依赖并为您提供framework框架。

Objective - C

1. 要使用Carthage将LLDebugTool集成到Xcode项目中，请在 Cartfile 中指定它:

   github "LLDebugTool"

2. 运行 carthage 来构建框架，并将构建的 LLDebugTool.framework 拖到Xcode项目中。

Swift

1. 要使用Carthage将LLDebugToolSwift集成到Xcode项目中，请在 Cartfile 中指定它:

   github "LLDebugToolSwift"

2. 运行 carthage 来构建框架，并将构建的 LLDebugToolSwift.framework 拖到Xcode项目中。

源文件

您可以直接将名为LLDebugTool文件夹的源文件添加到项目中。

Objective - C

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" 。

Swift

1. 下载 最新的Objective-C代码版本 或将存储库作为git子模块添加到您的git跟踪项目中。
2. 下载 最新的Swift扩展代码版本 或将存储库作为git子模块添加到您的git跟踪项目中。
3. 在Xcode中打开项目，然后拖拽名为“LLDebugTool”和“LLDebugToolSwift”的源文件夹到你的项目中。当提示Choose options for adding these files时，务必勾选Copy items if needed这项。
4. 集成 FMDB 到项目中，FMDB是一个围绕SQLite的Objective-C包装器开源库。
5. 在你需要使用LLDebugTool的文件里添加 import LLDebugToolSwift 。

如何使用

启动

你需要在"application:(UIApplication * )application didFinishLaunchingWithOptions:(NSDictionary * )launchOptions"中启动LLDebugTool，否则你可能会丢掉某些信息。

如果你想自定义一些参数，你需要在调用"startWorking"前配置这些参数。更详细的配置信息请看 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.")
    }
复制代码

网络请求

你不需要做任何操作，只需要调用了"startWorking"就可以监控大部分的网络请求，包括使用NSURLSession，NSURLConnection和AFNetworking。如果你发现某些情况下无法监控网络请求，请打开一个issue来告诉我。

崩溃

你不需要做任何操作，只需要调用"startWorking"就可以截获崩溃，保存崩溃信息、原因和堆栈信息，并且也会同时保存当次网络请求和日志信息。

App信息

LLDebugTool会监控app的CPU，内存和FPS。你可以更便捷的查看app的各种信息。

沙盒

LLDebugTool提供了一个快捷的方式来查看和操作沙盒文件，你可以更轻松的删除沙盒中的文件/文件夹，或者通过airdrop来分享文件/文件夹。只要是apple支持的文件格式，你可以直接通过LLDebugTool来预览。

更多使用

• 你可以通过查看 Wiki ，获得更多帮助。
• 你可以下载并运行 LLDebugToolDemo 或 LLDebugToolSwiftDemo 来发现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
  LLLogHelper
  LLNetworkHelper
  LLSandboxHelper
  LLStorageManager
  

• UserInterface UI文件。

  如果你想要修改、查看或者学习UI方面的东西，你可以查看一下这个文件夹。

  Base
  Categories
  Others
  Resources
  Sections
  Tool
  

联系

• 如果你需要帮助 ，打开一个issue。
• 如果你想问一个普遍的问题 ，打开一个issue。
• 如果你发现了一个bug ， 并能提供可靠的复制步骤 ，打开一个issue。
• 如果你有一个功能请求 ，打开一个issue。
• 如果你发现有什么不对或不喜欢的地方 ，就打开一个issue。
• 如果你有一些好主意或者一些需求 ，请发邮件( llworkinggroup@qq.com )给我。
• 如果你想贡献 ，提交一个pull request。