iOS开源项目之日志框架CocoaLumberjack

转载 2015年11月18日 14:40:37
CocoaLumberjack是Mac和iOS上一个集快捷、简单、强大和灵活于一身的日志框架。CocoaLumberjack类似于流行的日志框架(如log4j),但它是专为Objective-C设计的,利用了多线程、GCD(如果可用)、无锁原子操作Objective-C运行时的动态特性。
 
快速
在大多数用例中,Lumberjack比NSLog快了一个数量级。
 
简单
当应用程序启动时,只需一行加单的代码就可配置Lumberjack。然后用DDLog语句简单地取代NSLog语句。 并且DDLog宏与NSLog的有完全相同的格式和语法,所以超级简单。
 
强大
一个日志语句可以被发送到多个logger,意味着你可以同时记录文件和控制台。此外,还可以创建自己的logger,将日志语句发送到网络、数据库或者分布式文件系统中。没有任何限制。
 
灵活性
配置你自己想要的日志框架。修改每个文件的日志级别(尤其是测试时)。修改每个logger的日志级 别(详细的控制台,但是简洁的日志文件)。修改每个Xcode配置的日志级别。为你的应用程序定制日志级别的数量。添加自己的精细的日志。在运行时动态修改日志级别。 选择如何以及何时回滚你的日志文件。将日志文件上传至中心服务器。压缩存档日志文件来节省硬盘空间。
 
当你遇到一下情况是,你可以选择Lumberjack框架:
1.你想找到一种方式来跟踪在程序中不断出现的不可复制的bug;
2.你对iPhone上的简短日志感到很失望;
3.出于支持系统和稳定性的需要,你想将应用程序升级到下一级别;
4.为你的应用程序(Mac或者iPhone)寻找企业级的日志解决方案。
 
如何开始使用Lumberjack框架
 
开始
三步开始使用CocoaLumberjack框架:
1.将Lumberjack文件添加到你的项目中;
2.配置框架;
3.将NSLog指令转换为使用Lumberjack宏指令;

把Lumberjack框架添加到你的项目
需要添加的主要文件有四个:
1.@DDLog(整个框架的基础)
2.@DDASLLogger(发送日志语句到苹果的日志系统,以便它们显示在Console.app上)
3.@DDTTYLoyger(发送日志语句到Xcode控制台,如果可用)
4.@DDFIleLoger(把日志语句发送至文件)
 
DDLog是强制性的,其余的都是可选的,这取决于你打算如何使用这个框架。例如,如果你不打算纪录到一个文件,你可以跳过DDFileLogger,或者你想跳过ASL以便更快的文件记录,你可以跳过DDASLLoger。
 
配置框架
首先,你想要在你的应用程序中配置这个日志框架,通常在applicationDidFinishLaunching方法中配置。
 
开始时,你需要下面两行代码:
  1. [DDLog addLogger:[DDASLLogger sharedInstance]]; 
  2. [DDLog addLogger:[DDTTYLogger sharedInstance]]; 
这将在你的日志框架中添加两个“logger”。也就是说你的日志语句将被发送到Console.app和Xcode控制 台(就像标准的NSLog)
 
这个框架的好处之一就是它的灵活性,如果你还想要你的日志语句写入到一个文件中,你可以添加和配置一个file logger:
  1. fileLogger = [[DDFileLogger alloc] init]; 
  2. fileLogger.rollingFrequency = 60 * 60 * 24; // 24 hour rolling 
  3. fileLogger.logFileManager.maximumNumberOfLogFiles = 7; 
  4.  
  5. [DDLog addLogger:fileLogger]; 
 
上面的代码告诉应用程序要在系统上保持一周的日志文件。
 
用DDLog替换NSLog语句
DDLog的头文件定义了你用来替换NSLog语句的宏,本质上看起来向下边这样:
  1. // Convert from this: 
  2. NSLog(@"Broken sprocket detected!"); 
  3. NSLog(@"User selected file:%@ withSize:%u", filePath, fileSize); 
  4.  
  5. // To this: 
  6. DDLogError(@"Broken sprocket detected!"); 
  7. DDLogVerbose(@"User selected file:%@ withSize:%u", filePath, fileSize); 
我们看到DDLog宏和NSLog的语法完全相同。
 
所以你所要做的就是决定每个NSlog语句属于哪种日志级别。DDLog默认有四种级别的日志,分别是:
1.@DDlogError
2.@DDlogWarn
3.@DDlogInfo
4.@DDlogVerbose
 
 
当然选择哪个NSLog语句取决于你的消息的严重程度。
 
下面的这些不同的日志等级也许正有你所需要的:
1.如果你将日志级别设置为 LOG_LEVEL_ERROR,那么你只会看到DDlogError语句。
2.如果你将日志级别设置为LOG_LEVEL_WARN,那么你只会看到DDLogError和DDLogWarn语句。
3.如果您将日志级别设置为 LOG_LEVEL_INFO,那么你会看到error、Warn和Info语句。
4.如果您将日志级别设置为LOG_LEVEL_VERBOSE,那么你会看到所有DDLog语句。
5.如果您将日志级别设置为 LOG_LEVEL_OFF,你将不会看到任何DDLog语句。
 
那么我在哪里设置日志级别呢,在整个项目中我只能使用一个日志级别吗?
 
当然不是,我们都知道正如调试或者添加新特性,如果你想详细纪录目前正在做的那部分,Lumberjack框 架提供了对每个文件的调试控制,你仅可以修改编辑中的文件的日志级别。
 
(注释:当然还有许多其他高级选项,比如全球日志级别,Xcode的每个配置级别,每个logger级别等,我们将在另一篇文章中讲到)。
 
以下是如何转换你的日志语句:
  1. // CONVERT FROM THIS 
  2.  
  3. #import "Sprocket.h" 
  4.  
  5. @implementation Sprocket 
  6.  
  7. - (void)someMethod 
  8.     NSLog(@"Meet George Jetson"); 
  9.  
  10. @end 
  11.  
  12. // TO THIS 
  13.  
  14. #import "Sprocket.h" 
  15. #import "DDLog.h" 
  16.  
  17. static const int ddLogLevel = LOG_LEVEL_VERBOSE; 
  18.  
  19. @implementation Sprocket 
  20.  
  21. - (void)someMethod 
  22.     DDLogVerbose(@"Meet George Jetson"); 
  23.  
  24. @end 
 
注意日志级别声明为常量,这意味着这意味着日志级别阈值以上的DDLog语句都将编译到你的项目中。

iOS开源项目之日志框架CocoaLumberjack的使用

CocoaLumberjack是Mac和iOS上一个集快捷、简单、强大和灵活于一身的日志框架。CocoaLumberjack类似于流行的日志框架(如log4j),但它是专为Objective-C设计的...
  • xinxing260
  • xinxing260
  • 2014年12月11日 14:08
  • 449

IOS开发小技巧——强大的企业级调试日志——IOS第三方库CocoaLumberjack/CocoaLumberjack(1)

CocoaLumberjack是Mac和iOS上一个集快捷、简单、强大和灵活于一身的日志框架。CocoaLumberjack类似于流行的日志框架(如log4j),但它是专为Objective-C设计的...
  • github_29614995
  • github_29614995
  • 2015年07月13日 01:53
  • 712

iOS开发之日志框架CocoaLumberjack的配置与使用详解

源码地址: 点击打开链接 1. CocoaLumberjack这个框架是做什么的?   CocoaLumberjack是Mac和iOS上一个集快捷、简单、强大和灵活于一身的日志框架。CocoaLumb...
  • zhonggaorong
  • zhonggaorong
  • 2016年06月13日 14:00
  • 7863

iOS 获取日志框架CocoaLumberjack

笔者应老板要求,需要时时获取用户使用软件的一些信息。 这里有参考文章,已经写得很全了。简书链接...
  • xj_love
  • xj_love
  • 2017年04月20日 09:46
  • 501

iOS开源项目之 日志框架CocoaLumberjack

CocoaLumberjack是Mac和iOS上一个集快捷、简单、强大和灵活于一身的日志框架。CocoaLumberjack类似于流行的日志框架(如log4j),但它是专为Objective-C设计的...
  • shaobo8910
  • shaobo8910
  • 2015年12月30日 16:43
  • 387

iOS开源项目之日志框架CocoaLumberjack

转载地址:http://www.cocoachina.com/applenews/devnews/2014/0414/8157.html CocoaLumberjack是Mac和iOS上一个集快捷、...
  • ywch2010
  • ywch2010
  • 2014年04月15日 09:04
  • 510

iOS开发进阶 - 日志输出框架CocoaLumberjack与XcodeColors插件的简单使用(swift版)

CocoaLumberjack是Mac和iOS上一个集快捷、简单、强大和灵活于一身的日志框架。XcodeColors是用于控制台着色的工具,配合着CocoaLumberjack用有更好的效果,不废话,...
  • wang631106979
  • wang631106979
  • 2016年09月01日 22:46
  • 2450

iOS第三方库-CocoaLumberjack简单介绍

发现一个,很厉害的小工具,让xCode控制台输出文本有颜色! 闲话不说,上代码。 大概需要三个步骤: 一、安装xCode扩展插件XcodeColors。 二、引入第...
  • m18510011124
  • m18510011124
  • 2015年03月07日 12:01
  • 499

iOS第三方库-CocoaLumberjack-DDLog 使用

大概需要三个步骤: 一、安装xCode扩展插件XcodeColors。 二、引入第三方库CocoaLumberjack。 三、修改NSLog为DDLog方式。 一、安装xCode扩展插件...
  • kangguang
  • kangguang
  • 2016年04月19日 18:52
  • 1163

CocoaLumberjack使用以及日志文件获取

本文主要介绍之前项目中使用到CocoaLumberjack, 然后获取CocoaLumberjack为我们存储的日志文件, 在用户反馈的时候, 将日志文件打包上传到服务器, 以便我们查找错误信息。...
  • wlaizff
  • wlaizff
  • 2016年07月22日 16:17
  • 962
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:iOS开源项目之日志框架CocoaLumberjack
举报原因:
原因补充:

(最多只允许输入30个字)