DDLog優點

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

簡單 
當應用程式啟動時，只需一行加單的程式碼就可配置Lumberjack。然後用DDLog語句簡單地取代NSLog語句。 
根據你需要的功能新增不同的Loger，後面會介紹各個Loger的作用

[DDLog addLogger:[DDTTYLogger sharedInstance]];
[DDLog addLogger:[DDASLLogger sharedInstance]]; 
[DDLog addLogger:[DDTTYLogger sharedInstance]];

強大 
一個日誌語句可以被髮送到多個logger，意味著你可以同時記錄檔案和控制檯。此外，還可以建立自己的logger，將日誌語句傳送到網路、資料庫或者分散式檔案系統中。沒有任何限制。

靈活性 
配置你自己想要的日誌框架。修改每個檔案的日誌級別（尤其是測試時）。修改每個logger的日誌級 別（詳細的控制檯，但是簡潔的日誌檔案）。修改每個Xcode配置的日誌級別。為你的應用程式定製日誌級別的數量。新增自己的精細的日誌。在執行時動態修改日誌級別。 選擇如何以及何時回滾你的日誌檔案。將日誌檔案上傳至中心伺服器。壓縮存檔日誌檔案來節省硬碟空間。

什麼時候使用DDLog

1.你想找到一種方式來跟蹤在程式中不斷出現的不可複製的bug； 
2.你對iPhone上的簡短日誌感到很失望； 
3.出於支援系統和穩定性的需要，你想將應用程序升級到下一級別； 
4.為你的應用程式（Mac或者iPhone）尋找企業級的日誌解決方案

如何使用DDLog

開始 
三步開始使用CocoaLumberjack框架： 
1.將Lumberjack檔案新增到你的專案中； 
2.配置框架； 
3.將NSLog指令轉換為使用Lumberjack巨集指令； 
 
把Lumberjack框架新增到你的專案 
需要新增的主要檔案有四個： 
[email protected]（整個框架的基礎） 
[email protected]（傳送日誌語句到蘋果的日誌系統，以便它們顯示在Console.app上） 
[email protected]（傳送日誌語句到Xcode控制檯，如果可用） 
[email protected]

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

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

開始時，你需要下面兩行程式碼：

[DDLog addLogger:[DDASLLogger sharedInstance]]; 
[DDLog addLogger:[DDTTYLogger sharedInstance]]; 

這將在你的日誌框架中新增兩個“logger”。也就是說你的日誌語句將被髮送到Console.app和Xcode控制 臺（就像標準的NSLog）

這個框架的好處之一就是它的靈活性，如果你還想要你的日誌語句寫入到一個檔案中，你可以新增和配置一個file logger:

fileLogger = [[DDFileLogger alloc] init]; 
fileLogger.rollingFrequency = 60 * 60 * 24; // 24 hour rolling  
fileLogger.logFileManager.maximumNumberOfLogFiles = 7;  
[DDLog addLogger:fileLogger]; 

上面的程式碼告訴應用程式要在系統上保持一週的日誌檔案。

用DDLog替換NSLog語句 
DDLog的標頭檔案定義了你用來替換NSLog語句的巨集，本質上看起來向下邊這樣：

// Convert from this: 
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預設有四種級別的日誌，分別是：

<code class="hljs ruby has-numbering" style="display: block; padding: 0px; background-color: transparent; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-top-left-radius: 0px; border-top-right-radius: 0px; border-bottom-right-radius: 0px; border-bottom-left-radius: 0px; word-wrap: normal; background-position: initial initial; background-repeat: initial initial;"><span class="hljs-number" style="color: rgb(0, 102, 102); box-sizing: border-box;">1</span>.<span class="hljs-variable" style="color: rgb(102, 0, 102); box-sizing: border-box;">@DDlogError</span>
<span class="hljs-number" style="color: rgb(0, 102, 102); box-sizing: border-box;">2</span>.<span class="hljs-variable" style="color: rgb(102, 0, 102); box-sizing: border-box;">@DDlogWarn</span>
<span class="hljs-number" style="color: rgb(0, 102, 102); box-sizing: border-box;">3</span>.<span class="hljs-variable" style="color: rgb(102, 0, 102); box-sizing: border-box;">@DDlogInfo</span>
<span class="hljs-number" style="color: rgb(0, 102, 102); box-sizing: border-box;">4</span>.<span class="hljs-variable" style="color: rgb(102, 0, 102); box-sizing: border-box;">@DDlogVerbose</span></code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; background-color: rgb(238, 238, 238); top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right;"><li style="box-sizing: border-box; padding: 0px 5px;">1</li><li style="box-sizing: border-box; padding: 0px 5px;">2</li><li style="box-sizing: border-box; padding: 0px 5px;">3</li><li style="box-sizing: border-box; padding: 0px 5px;">4</li></ul>

（注意：你也可以自定義級別以及級別名或者新增更精細的控制來代替系統四個簡單的等級。）

當然選擇哪個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級別等，我們將在另一篇文章中講到)。

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

<code class="hljs objectivec has-numbering" style="display: block; padding: 0px; background-color: transparent; color: inherit; box-sizing: border-box; font-family: 'Source Code Pro', monospace;font-size:undefined; white-space: pre; border-top-left-radius: 0px; border-top-right-radius: 0px; border-bottom-right-radius: 0px; border-bottom-left-radius: 0px; word-wrap: normal; background-position: initial initial; background-repeat: initial initial;"><span class="hljs-comment" style="color: rgb(136, 0, 0); box-sizing: border-box;">// CONVERT FROM THIS </span>

<span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#import <span class="hljs-title" style="box-sizing: border-box;">"Sprocket.h"</span> </span>

<span class="hljs-class" style="box-sizing: border-box;"><span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">@implementation</span> <span class="hljs-title" style="box-sizing: border-box; color: rgb(102, 0, 102);">Sprocket</span> </span>

- (<span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">void</span>)someMethod 
{ 
    <span class="hljs-built_in" style="color: rgb(102, 0, 102); box-sizing: border-box;">NSLog</span>(@<span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;">"Meet George Jetson"</span>); 
} 

<span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">@end</span> 

<span class="hljs-comment" style="color: rgb(136, 0, 0); box-sizing: border-box;">// TO THIS </span>

<span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#import <span class="hljs-title" style="box-sizing: border-box;">"Sprocket.h"</span> </span>
<span class="hljs-preprocessor" style="color: rgb(68, 68, 68); box-sizing: border-box;">#import <span class="hljs-title" style="box-sizing: border-box;">"DDLog.h"</span> </span>

<span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">static</span> <span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">const</span> <span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">int</span> ddLogLevel = LOG_LEVEL_VERBOSE; 

<span class="hljs-class" style="box-sizing: border-box;"><span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">@implementation</span> <span class="hljs-title" style="box-sizing: border-box; color: rgb(102, 0, 102);">Sprocket</span> </span>

- (<span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">void</span>)someMethod 
{ 
    DDLogVerbose(@<span class="hljs-string" style="color: rgb(0, 136, 0); box-sizing: border-box;">"Meet George Jetson"</span>); 
} 

<span class="hljs-keyword" style="color: rgb(0, 0, 136); box-sizing: border-box;">@end</span> 
</code><ul class="pre-numbering" style="box-sizing: border-box; position: absolute; width: 50px; background-color: rgb(238, 238, 238); top: 0px; left: 0px; margin: 0px; padding: 6px 0px 40px; border-right-width: 1px; border-right-style: solid; border-right-color: rgb(221, 221, 221); list-style: none; text-align: right;"><li style="box-sizing: border-box; padding: 0px 5px;">1</li><li style="box-sizing: border-box; padding: 0px 5px;">2</li><li style="box-sizing: border-box; padding: 0px 5px;">3</li><li style="box-sizing: border-box; padding: 0px 5px;">4</li><li style="box-sizing: border-box; padding: 0px 5px;">5</li><li style="box-sizing: border-box; padding: 0px 5px;">6</li><li style="box-sizing: border-box; padding: 0px 5px;">7</li><li style="box-sizing: border-box; padding: 0px 5px;">8</li><li style="box-sizing: border-box; padding: 0px 5px;">9</li><li style="box-sizing: border-box; padding: 0px 5px;">10</li><li style="box-sizing: border-box; padding: 0px 5px;">11</li><li style="box-sizing: border-box; padding: 0px 5px;">12</li><li style="box-sizing: border-box; padding: 0px 5px;">13</li><li style="box-sizing: border-box; padding: 0px 5px;">14</li><li style="box-sizing: border-box; padding: 0px 5px;">15</li><li style="box-sizing: border-box; padding: 0px 5px;">16</li><li style="box-sizing: border-box; padding: 0px 5px;">17</li><li style="box-sizing: border-box; padding: 0px 5px;">18</li><li style="box-sizing: border-box; padding: 0px 5px;">19</li><li style="box-sizing: border-box; padding: 0px 5px;">20</li><li style="box-sizing: border-box; padding: 0px 5px;">21</li><li style="box-sizing: border-box; padding: 0px 5px;">22</li><li style="box-sizing: border-box; padding: 0px 5px;">23</li><li style="box-sizing: border-box; padding: 0px 5px;">24</li><li style="box-sizing: border-box; padding: 0px 5px;">25</li><li style="box-sizing: border-box; padding: 0px 5px;">26</li><li style="box-sizing: border-box; padding: 0px 5px;">27</li><li style="box-sizing: border-box; padding: 0px 5px;">28</li><li style="box-sizing: border-box; padding: 0px 5px;">29</li></ul>

注意日誌級別宣告為常量，這意味著這意味著日誌級別閾值以上的DDLog語句都將編譯到你的專案中。

自動引用計數（ARC） 
最新版本的Lumberjack使用ARC。如果你的專案沒有使用ARC，你可以在ARC頁面學習如何在Xcode中像ARC一樣正確地標記Lumberjack檔案。