iOS开发—日志框架 CocoaLumberjack的配置使用

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"

     2.第二种配置放方法是直接“拖拽”进工程。添加文件。  

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. 开始在程序中进行设置。

        

[objc]  view plain  copy

1. - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {  
2.     // Override point for customization after application launch.  
3.       
4.     [DDLog addLogger:[DDASLLogger sharedInstance]];  
5.     [DDLog addLogger:[DDTTYLogger sharedInstance]];  
6.     return YES;  
7. }  

     在程序最开始的运行的地方就进行一个log的初始化， 这样做的作用就是在你的日志框架中添加两个“logger”。也就是说你的日志语句将被发送到Console.app和Xcode控制 台（就像标准的NSLog）

  如果你需要把这些日志添加到文件中，那么这个时候你就用到了DDFIleLoger。使用方法如下

[objc]  view plain  copy

1. DDFileLogger *fileLogger = [[DDFileLogger alloc] init];  
2.   //保存周期  
3.   fileLogger.rollingFrequency = 660 * 660 * 24; // 24 hour rolling  
4.   //最大的日志文件数量  
5.   fileLogger.logFileManager.maximumNumberOfLogFiles = 7;  
6.     
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：关闭日志

  以上简单使用。

=============================================================================================

The last：（自己根据自己的项目简单的再封装）

#ifdef DEBUG  // 调试状态

// 打开LOG功能

#define OKAY_LOG(fmt, ...) do {                                           \

    NSString* file = [[NSString alloc] initWithFormat:@"%s", __FILE__]; \

    DDLogError((@"%@(%s)(line:%d) " fmt), [file lastPathComponent], __PRETTY_FUNCTION__, __LINE__, ##__VA_ARGS__); \

    file = nil;                                                 \

} while(0)

#else // 发布状态

// 关闭LOG功能

#define DDLogError(...)

#endif