Click here for an English introduction
LLDebugTool是一款针对开发者和测试者的调试工具,它可以帮助你在非Xcode的情况下,进行数据分析和操作。
LLDebugToolSwift是针对LLDebugTool的Swift扩展,它提供了LLDebugTool的Swift接口,LLDebugToolSwift会和LLDebugTool同步更新。
如果你的项目是一个Objective-C项目,你可以使用LLDebugTool
,如果你的项目是一个Swift项目或者包含Swift文件,你可以使用LLDebugToolSwift
。
为您的下一个项目选择LLDebugTool,或者迁移到您现有的项目中——您会为此感到惊喜!🎊🎊🎊
模拟定位
功能和组件化。LLDebugTool/{subspec}
去集成某些组件,例如 LLDebugTool/Network
、LLDebugToolLog
。模拟定位
功能,现在你可以在任何时候模拟到任何地点。支持CLLocationManager
和 MKMapView
。generate_multiple_pod_projects
。检查网络请求或者查看某些事件的日志信息,而不必非在XCode运行下运行。这在解决测试人员的问题上很有用。
更轻松的筛选有用的信息。
更轻松的处理偶发的问题。
更轻松的分析崩溃原因。
更轻松的分享、预览或删除沙盒文件,这在开发阶段非常有用。
更轻松的观察App的CPU,内存,FPS等信息。
截屏、标注并分享。
更直观的查看视图结构,并修改具体属性值。
更准确地确定App里的UI元素和颜色。
便捷的获取和对比位置信息。
便捷的查看元素边框及位置。
快速的Html容器入口。
模拟定位。
CocoaPods 是集成LLDebugTool
的首选方式。
- 添加
pod 'LLDebugTool' , '~> 1.0'
到你的Podfile里。- 如果只想在Debug模式下使用,则添加
pod 'LLDebugTool' , '~> 1.0' ,:configurations => ['Debug']
到你的Podfile里,详细的配置方式可以查看Wiki/如何仅在Debug环境中使用。如果你想要指定某个版本,可以类似这样使用pod 'LLDebugTool' , '1.3.7' ,:configurations => ['Debug']
。- 推荐的方式是采用多Target来处理,只在Debug Target中添加
pod 'LLDebugTool' , '~> 1.0'
,这样做的好处既不污染Product环境的代码,又可以在Archive Debug环境的App时,将LLDebugTool
集成进去(如果采用:configurations => ['Debug']
的方式,只能通过XCode运行,不可以Archive成App)。- 终端输入
pod install
来进行集成。搜索不到LLDebugTool
或者搜不到最新版本时,可先运行pod repo update
,再执行pod install
。- 在你需要使用LLDebugTool的文件里添加
#import "LLDebug.h"
,或者直接在pch文件中添加#import "LLDebug.h"
。
- 添加
pod 'LLDebugToolSwift' , '~> 1.0'
到你的Podfile里。- 如果只想在Debug模式下使用,则添加
pod 'LLDebugToolSwift' , '~> 1.0' ,:configurations => ['Debug']
到你的Podfile里,详细的配置方式可以查看Wiki/如何仅在Debug环境中使用。如果你想要指定某个版本,可以类似这样使用pod 'LLDebugToolSwift' , '1.3.7' ,:configurations => ['Debug']
。- 推荐的方式是采用多Target来处理,只在Debug Target中添加
pod 'LLDebugToolSwift' , '~> 1.0'
,这样做的好处既不污染Product环境的代码,又可以在Archive Debug环境的App时,将LLDebugToolSwift
集成进去(如果采用:configurations => ['Debug']
的方式,只能通过XCode运行,不可以Archive成App)。- 必须在Podfile中添加
use_frameworks!
。- 终端输入
pod install
来进行集成。搜索不到LLDebugToolSwift
或者搜不到最新版本时,可先运行pod repo update
,再执行pod install
。- 在你需要使用LLDebugTool的文件里添加
import LLDebugToolSwift
。
Carthage 是一个分散的依赖管理器,它构建您的依赖并为您提供framework框架。
要使用Carthage将LLDebugTool集成到Xcode项目中,请在
Cartfile
中指定它:
github "LLDebugTool"
运行
carthage
来构建框架,并将构建的LLDebugTool.framework
拖到Xcode项目中。
要使用Carthage将LLDebugToolSwift集成到Xcode项目中,请在
Cartfile
中指定它:
github "LLDebugToolSwift"
运行
carthage
来构建框架,并将构建的LLDebugToolSwift.framework
拖到Xcode项目中。
您可以直接将名为LLDebugTool文件夹的源文件添加到项目中。
- 下载最新的代码版本或将存储库作为git子模块添加到您的git跟踪项目中。
- 在Xcode中打开项目,然后拖拽名为“LLDebugTool”的源文件夹到你的项目中。当提示Choose options for adding these files时,务必勾选Copy items if needed这项。
- 集成FMDB到项目中,FMDB是一个围绕SQLite的Objective-C包装器开源库。
- 集成Masonry到项目中,Masonry是一个约束库。
- 在你需要使用LLDebugTool的文件里添加
#import "LLDebug.h"
,或者直接在pch文件中添加#import "LLDebug.h"
。
- 下载最新的Objective-C代码版本或将存储库作为git子模块添加到您的git跟踪项目中。
- 下载最新的Swift扩展代码版本或将存储库作为git子模块添加到您的git跟踪项目中。
- 在Xcode中打开项目,然后拖拽名为“LLDebugTool”和“LLDebugToolSwift”的源文件夹到你的项目中。当提示Choose options for adding these files时,务必勾选Copy items if needed这项。
- 集成FMDB到项目中,FMDB是一个围绕SQLite的Objective-C包装器开源库。
- 集成Masonry到项目中,Masonry是一个约束库。
- 在你需要使用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 {
// Start working with config.
[[LLDebugTool sharedTool] startWorkingWithConfigBlock:^(LLConfig * _Nonnull config) {
//####################### Color Style #######################//
// Uncomment one of the following lines to change the color configuration.
// config.colorStyle = LLConfigColorStyleSystem;
// [config configBackgroundColor:[UIColor orangeColor] primaryColor:[UIColor whiteColor] statusBarStyle:UIStatusBarStyleDefault];
//####################### User Identity #######################//
// Use this line to tag user. More config please see "LLConfig.h".
config.userIdentity = @"Miss L";
//####################### Window Style #######################//
// Uncomment one of the following lines to change the window style.
// config.entryWindowStyle = LLConfigEntryWindowStyleNetBar;
}];
return YES;
}
In Swift
import LLDebugToolSwift
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// Start working with config.
LLDebugTool.shared().startWorking { (config) in
//####################### Color Style #######################//
// Uncomment one of the following lines to change the color configuration.
// config.colorStyle = .system
// config.configBackgroundColor(.orange, textColor: .white, statusBarStyle: .default)
//####################### User Identity #######################//
// Use this line to tag user. More config please see "LLConfig.h".
config.userIdentity = "Miss L";
//####################### Window Style #######################//
// Uncomment one of the following lines to change the window style.
// config.windowStyle = .netBar
//####################### Features #######################//
// Uncomment this line to change the available features.
// config.availables = .noneAppInfo
}
return true
}
你不需要做任何操作,只需要调用了"startWorking"就可以监控大部分的网络请求,包括使用NSURLSession,NSURLConnection和AFNetworking。如果你发现某些情况下无法监控网络请求,请打开一个issue来告诉我。
打印和保存一个日志。 更多的log宏信息查看LLDebugToolMacros.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"就可以截获崩溃,保存崩溃信息、原因和堆栈信息,并且也会同时保存当次网络请求和日志信息。
LLDebugTool会监控app的CPU,内存和FPS。你可以更便捷的查看app的各种信息。
LLDebugTool提供了一个快捷的方式来查看和操作沙盒文件,你可以更轻松的删除沙盒中的文件/文件夹,或者通过airdrop来分享文件/文件夹。只要是apple支持的文件格式,你可以直接通过LLDebugTool来预览。
LLDebugTool提供了一个截屏功能,并且可以进行简单的绘画和标注,用于测试或者美工调试App时方便记录。
LLDebugTool提供了一个视图结构工具,用于在非Debug模式下查看或者修改元素的属性和信息。
LLDebugTool提供了一个放大镜的工具,用于放大局部UI和查看指定位置的颜色值。
LLDebugTool提供了一个格尺工具,用于便捷的获取和对比位置信息。
LLDebugTool提供了一个元素边框工具,便捷的查看元素边框及位置。
LLDebugTool可以在你的app中随时调试通过 WKWebView
,UIWebView
或者你自定义的ViewController
来调试html页面。
LLDebugTool可以随时在你的app中模拟定位信息,支持 CLLocationManager
和 MKMapView
。
LLDebugTool在支持ios8+,并且需要使用ARC模式。使用到的框架已经包含在大多数Xcode模板中:
UIKit
Foundation
SystemConfiguration
Photos
QuickLook
CoreTelephony
CoreLocation
MapKit
LLDebug.h
公用头文件。全局引用此文件即可。
DebugTool
LLDebugTool.h
用于启动和停止LLDebugTool,你需要看一下这个文件。
LLConfig.h
用于自定义颜色、大小、标识和其他信息。如果您想要配置任何东西,您需要关注这个文件。
LLDebugToolMacros.h
快捷的宏定义文件。
Component
Network
用于监视网络请求。Log
快速打印和保存日志。Crash
用于当App发生崩溃时,收集崩溃信息。AppInfo
用于监视应用程序的各种属性。Sandbox
用于查看和操作沙盒文件。Screenshot
用于处理和展示截屏事件。Hierarchy
用于处理和展示视图结构。Magnifier
用于放大镜功能。Ruler
用于格尺功能。Widget Border
用于元素边框功能。Html
用于动态调试Web界面。Location
用于模拟定位功能。Function
用于展示功能列表。Setting
用于动态修改配置。可以在 CHANGELOG 中找到每个LLDebugTool版本的简要总结。
这段代码是根据 MIT license 的条款和条件发布的。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。