iOS開源項目之日志框架CocoaLumberjack(未整理版)

CocoaLumberjack是Mac和iOS上一個集快捷、簡單、強大和靈活于一身的日志框架。CocoaLumberjack類似于流行 的日志框架(如log4j),但它是專為Objective-C設計的,利用了多線程、GCD(如果可用)、無鎖原子操作Objective-C運行時的 動態特性。

快速?在大多數用例中,Lumberjack比NSLog快了一個數量級。

簡單?當應用程序啟動時,只需一行加單的代碼就可配置Lumberjack。然后用DDLog語句簡單地取代NSLog語句。 并且DDLog宏與NSLog的有完全相同的格式和語法,所以超級簡單。

強大?一個日志語句可以被發送到多個logger,意味著你可以同時記錄文件和控制臺。此外,還可以創建自己的logger,將日志語句發送到網絡、數據庫或者分布式文件系統中。沒有任何限制。

靈活性?配置你自己想要的日志框架。修改每個文件的日志級別(尤其是測試時)。修改每個logger的日志級 別(詳細的控制臺,但是簡潔的日志文件)。修改每個Xcode配置的日志級別。為你的應用程序定制日志級別的數量。添加自己的精細的日志。在運行時動態修 改日志級別。 選擇如何以及何時回滾你的日志文件。將日志文件上傳至中心服務器。壓縮存檔日志文件來節省硬盤空間。

當你遇到一下情況是,你可以選擇Lumberjack框架

1.你想找到一種方式來跟蹤在程序中不斷出現的不可復制的bug;

2.你對iPhone上的簡短日志感到很失望;

3.出于支持系統和穩定性的需要,你想將應用程序升級到下一級別;

4.為你的應用程序(Mac或者iPhone)尋找企業級的日志解決方案。

如何開始使用Lumberjack框架

1.將Lumberjack文件添加到你的項目中;

2.配置框架;

3.將NSLog指令轉換為使用Lumberjack宏指令;

把Lumberjack框架添加到你的項目

需要添加的主要文件有四個:

1.@DDLog(整個框架的基礎)

2.@DDASLLogger(發送日志語句到蘋果的日志系統,以便它們顯示在Console.app上)

3.@DDTTYLoyger(發送日志語句到Xcode控制臺,如果可用)

4.@DDFIleLoger(把日志語句發送至文件)

DDLog是強制性的,其余的都是可選的,這取決于你打算如何使用這個框架。例如,如果你不打算紀錄到一個文件,你可以跳過DDFileLogger,或者你想跳過ASL以便更快的文件記錄,你可以跳過DDASLLoger

配置框架

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

? fileLogger = [[DDFileLogger alloc] init];

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

?fileLogger.logFileManager.maximumNumberOfLogFiles = 7;

?[DDLog addLogger:fileLogger];

上面的代碼告訴應用程序要在系統上保持一周的日志文件。

用DDLog替換NSLog語句

DDLog的頭文件定義了你用來替換NSLog語句的宏,本質上看起來向下邊這樣:

NSLog(@"Broken sprocket detected!");

NSLog(@"User selected file:%@ withSize:%u", filePath, fileSize);

// To this:

DDLogError(@"Broken sprocket detected!");

DDLogVerbose(@"User selected file:%@ withSize:%u", filePath, fileSize);

我們看到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級別等,我們將在另一篇文章中講到)。

6.使用DDLog.

直接貼代碼:

static const int ddLogLevel = LOG_LEVEL_VERBOSE;// 定義日志級別

[DDLog addLogger:[DDTTYLogger sharedInstance]];// 初始化DDLog日志輸出,在這里,我們僅僅希望在xCode控制臺輸出

[[DDTTYLogger sharedInstance] setColorsEnabled:YES];// 啟用顏色區分

DDLogError(@"錯誤信息"); // 紅色

DDLogWarn(@"警告"); // 橙色

DDLogInfo(@"提示信息"); // 默認是黑色

DDLogVerbose(@"詳細信息"); // 默認是黑色

以上是最簡單的應用,當然,可以自定義每種日志的顏色,看需求吧。

[DDLog addLogger:[DDASLLogger sharedInstance]];// 如果需要,可以添加其他的日志輸出支持

[[DDTTYLogger sharedInstance] setForegroundColor:[UIColor blueColor] backgroundColor:nil forFlag:LOG_FLAG_INFO];// 可以修改你想要的顏色

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,461評論 6 532
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,538評論 3 417
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,423評論 0 375
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,991評論 1 312
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,761評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,207評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,268評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,419評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,959評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,782評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,983評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,528評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,222評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,653評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,901評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,678評論 3 392
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,978評論 2 374

推薦閱讀更多精彩內容