【源碼】iOS日志管理(一)------日志框架CocoaLumberjack

 

如何開始使用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級別等，我們將在另一篇文章中講到)。

 

以下是如何轉換你的日志語句：

// CONVERT FROM THIS

#import "Sprocket.h"

@implementation Sprocket

- (void)someMethod
{
    NSLog(@"Meet George Jetson");
}

@end

// TO THIS

#import "Sprocket.h"
#import "DDLog.h"

static const int ddLogLevel = LOG_LEVEL_VERBOSE;

@implementation Sprocket

- (void)someMethod
{
    DDLogVerbose(@"Meet George Jetson");
}

@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");

 }