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

时间:2021-03-02 19:51:01

源码地址: 点击打开链接

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 你的项目名 iOS开发之日志框架CocoaLumberjack的配置与使用详解         3. 配置工程, 设置依赖             iOS开发之日志框架CocoaLumberjack的配置与使用详解         4.   Add "$(BUILT_PRODUCTS_DIR)/include" to the Header Search Paths iOS开发之日志框架CocoaLumberjack的配置与使用详解 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:关闭日志


使用:

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