如何开始使用Lumberjack框架



 



项目导入CocoaLumberjack



在pod文件中加入



#日志

pod 'CocoaLumberjack'

更新pod install

完成



开始



三步开始使用CocoaLumberjack框架:



1.将Lumberjack文件添加到你的项目中;



2.配置框架;



3.将NSLog指令转换为使用Lumberjack宏指令;




把Lumberjack框架添加到你的项目



 



需要在AppDelegate.h中添加的主要文件有四个:



#import <DDLog.h>//整个框架的基础

#import <DDASLLogger.h>//发送日志语句到苹果的日志系统,以便它们显示在Console.app上

#import <DDTTYLogger.h>//发送日志语句到Xcode控制台,如果可用

#import <DDFileLogger.h>//把日志语句发送至文件



 



DDLog是强制性的,其余的都是可选的,这取决于你打算如何使用这个框架。例如,如果你不打算纪录到一个文件,你可以跳过DDFileLogger,或者你想跳过ASL以便更快的文件记录,你可以跳过DDASLLoger。



 



配置框架



首先,你想要在你的应用程序中配置这个日志框架,通常在applicationDidFinishLaunching方法中配置。



 



开始时,你需要下面两行代码:



[DDLog addLogger:[DDASLLogger sharedInstance]]; 



[DDLog addLogger:[DDTTYLogger sharedInstance]]; 



这将在你的日志框架中添加两个“logger”。



也就是说你的日志语句将被发送到Console.app和Xcode控制 台(就像标准的NSLog)



 



这个框架的好处之一就是它的灵活性,如果你还想要你的日志语句写入到一个文件中,你可以添加和配置一个file logger:



    DDFileLogger *fileLogger = [[DDFileLogger alloc] init];

    fileLogger.rollingFrequency = 60 * 60 * 24; // 24 hour rolling

    fileLogger.logFileManager.maximumNumberOfLogFiles = 7;

    [DDLog addLogger:fileLogger];



 



上面的代码告诉应用程序要在系统上保持一周的日志文件。



 



用DDLog替换NSLog语句



DDLog的头文件定义了你用来替换NSLog语句的宏,本质上看起来向下边这样:



    DDLogVerbose(@"Verbose");

    DDLogDebug(@"Debug");

    DDLogInfo(@"Info");

    DDLogWarn(@"Warn");

    DDLogError(@"Error");



 



我们看到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. { 
9. "Meet George Jetson"); 
10. } 
11.  
12. @end 
13.  
14. // TO THIS 
15.  
16. #import "Sprocket.h" 
17. #import "DDLog.h" 
18.  
19. static const int ddLogLevel = LOG_LEVEL_VERBOSE; 
20.  
21. @implementation Sprocket 
22.  
23. - (void)someMethod 
24. { 
25. "Meet George Jetson"); 
26. } 
27.  
28. @end 

      
  
 
  

    注意日志级别声明为常量,这意味着这意味着日志级别阈值以上的DDLog语句都将编译到你的项目中。 
  
 
  

      
  
 
  
 
   下面上代码了 
  
 
  

      
  
 
  

    =================================================================================== 
  
 
  
#import "AppDelegate.h"
//日志
#import <DDLog.h>//整个框架的基础
#import <DDASLLogger.h>//发送日志语句到苹果的日志系统,以便它们显示在Console.app上
#import <DDTTYLogger.h>//发送日志语句到Xcode控制台,如果可用
#import <DDFileLogger.h>//把日志语句发送至文件
 
//日志级别阈值以上的DDLog语句都将编译到你的项目中。
//DDLog 必须配置打印级别
//下面的这些不同的日志等级也许正有你所需要的:
//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语句。
static const int ddLogLevel = LOG_LEVEL_VERBOSE;
 
 
  

      
  
 
  
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
 
//    [DDLog addLogger:[DDASLLogger sharedInstance]];
    [DDLog addLogger:[DDTTYLogger sharedInstance]];
 
    DDFileLogger *fileLogger = [[DDFileLogger alloc] init];
    fileLogger.rollingFrequency = 60 * 60 * 24; // 24 hour rolling
    fileLogger.logFileManager.maximumNumberOfLogFiles = 7;
    [DDLog addLogger:fileLogger];
 
    DDLogVerbose(@"Verbose");
    DDLogDebug(@"Debug");
    DDLogInfo(@"Info");
    DDLogWarn(@"Warn");
    DDLogError(@"Error");
 }