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"

普通方式添加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 {    // Override point for customization after application launch.        [DDLog addLogger:[DDASLLogger sharedInstance]];    [DDLog addLogger:[DDTTYLogger sharedInstance]];    return YES;}

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

  如果你需要把这些日志添加到文件中，那么这个时候你就用到了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：关闭日志

使用：