源码地址: 点击打开链接
1. CocoaLumberjack这个框架是做什么的?
CocoaLumberjack是Mac和iOS上一个集快捷、简单、强大和灵活于一身的日志框架。CocoaLumberjack类似于流行 的日志框架(如log4j),但它是专为Objective-C设计的,利用了多线程、GCD(如果可用)、无锁原子操作Objective-C运行时的 动态特性。
2. CocoaLumberjack 它的优点有哪些?
快速
在大多数用例中,Lumberjack比NSLog快了一个数量级。
简单
当应用程序启动时,只需一行加单的代码就可配置Lumberjack。然后用DDLog语句简单地取代NSLog语句,使用方法与NSLog完全一样
灵活性
配置你自己想要的日志框架。修改每个文件的日志级别(尤其是测试时)。修改每个logger的日志级 别(详细的控制台,但是简洁的日志文件)。修改每个Xcode配置的日志级别。为你的应用程序定制日志级别的数量。添加自己的精细的日志。在运行时动态修 改日志级别。 选择如何以及何时回滚你的日志文件。将日志文件上传至中心服务器。压缩存档日志文件来节省硬盘空间,一个日志语句可以被发送到多个logger,意味着你可以同时记录文件和控制台。此外,还可以创建自己的logger,将日志语句发送到网络、数据库或者分布式文件系统中,日志保存方法十分灵活。
3.CocoaLumberjack的使用场景
1.跟踪在程序中不断出现的不可复制的bug;
2.对原声的系统日志感到失望
3.出于支持系统和稳定性的需要,你想将应用程序升级到下一级别;
4.为你的应用程序(Mac或者iPhone)寻找企业级的日志解决方案。
5. 自定义日志级别,查看对应安全级别的日志。
4. CocoaLumberjack的使用
1.配置CocoaPods
platform :ios, '8.0'
pod 'CocoaLumberjack'
Carthage
- Cartfile
github "CocoaLumberjack/CocoaLumberjack"
普通方式添加CocoaLumberjack
1. 下载下来CocoaLumberjack源码
2. 把Lumberjack.xcodeproj添加到你的项目中,通过add file to 你的项目名
3. 配置工程, 设置依赖
4. Add "$(BUILT_PRODUCTS_DIR)/include"
to the Header Search Paths
5. 现在在你的pch文件中 加上 #import<CocoaLumberjack/CocoaLumberjack.h> ,编译项目,应该是成功了。
2. CocoaLumberjack的详细使用。 1.如果想要支持彩色日志效果,这儿需要用 package manager 装上XcodeColors这个插件。 2.认识下面几个常用的类
1.DDLog(整个框架的基础)
2.DDASLLogger(发送日志语句到苹果的日志系统,以便它们显示在Console.app上)
3.DDTTYLoyger(发送日志语句到Xcode控制台,如果可用)
4.DDFIleLoger(把日志语句发送至文件)
DDLog是强制性的,其余的都是可选的,这取决于你打算如何使用这个框架。例如,如果你不打算纪录到一个文件,你可以跳过DDFileLogger,或者你想跳过ASL以便更快的文件记录,你可以跳过DDASLLoger。
3. 开始在程序中进行设置。
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {在程序最开始的运行的地方就进行一个log的初始化, 这样做的作用就是在你的日志框架中添加两个“logger”。也就是说你的日志语句将被发送到Console.app和Xcode控制 台(就像标准的NSLog)
// Override point for customization after application launch.
[DDLog addLogger:[DDASLLogger sharedInstance]];
[DDLog addLogger:[DDTTYLogger sharedInstance]];
return YES;
}
如果你需要把这些日志添加到文件中,那么这个时候你就用到了DDFIleLoger。使用方法如下
DDFileLogger *fileLogger = [[DDFileLogger alloc] init];
//保存周期
fileLogger.rollingFrequency = 60 * 60 * 24; // 24 hour rolling
//最大的日志文件数量
fileLogger.logFileManager.maximumNumberOfLogFiles = 7;
[DDLog addLogger:fileLogger];
4. 最重要的部分。 用DDLog替换NSLog语句
DDLog的输出级别默认提供以下若干种:
DDLogError:定义输出错误文本
DDLogWarn:定义输出警告文本
DDLogInfo:定义输出信息文本
DDLogDebug:定义输出调试文本
DDLogVerbose:定义输出详细文本
提供的日志级别为:
LOG_LEVEL_ERROR:只显示错误日志。
LOG_LEVEL_WARN:包括:LOG_LEVEL_ERROR
LOG_LEVEL_INFO:包括:LOG_LEVEL_WARN
LOG_LEVEL_DEBUG:包括:LOG_LEVEL_INFO
LOG_LEVEL_VERBOSE:包括:LOG_LEVEL_DEBUG
LOG_LEVEL_OFF:关闭日志
使用: