CocoaLumberjack是Mac和iOS上一個集快捷、簡單、強大和靈活于一身的日志框架。CocoaLumberjack類似于流行 的日志框架(如log4j),但它是專為Objective-C設(shè)計的,利用了多線程、GCD(如果可用)、無鎖原子操作Objective-C運行時的 動態(tài)特性。
快速
在大多數(shù)用例中,Lumberjack比NSLog快了一個數(shù)量級。
簡單
當(dāng)應(yīng)用程序啟動時,只需一行加單的代碼就可配置Lumberjack。然后用DDLog語句簡單地取代NSLog語句。 并且DDLog宏與NSLog的有完全相同的格式和語法,所以超級簡單。
強大
一個日志語句可以被發(fā)送到多個logger,意味著你可以同時記錄文件和控制臺。此外,還可以創(chuàng)建自己的logger,將日志語句發(fā)送到網(wǎng)絡(luò)、數(shù)據(jù)庫或者分布式文件系統(tǒng)中。沒有任何限制。
靈活性
配置你自己想要的日志框架。修改每個文件的日志級別(尤其是測試時)。修改每個logger的日志級 別(詳細(xì)的控制臺,但是簡潔的日志文件)。修改每個Xcode配置的日志級別。為你的應(yīng)用程序定制日志級別的數(shù)量。添加自己的精細(xì)的日志。在運行時動態(tài)修 改日志級別。 選擇如何以及何時回滾你的日志文件。將日志文件上傳至中心服務(wù)器。壓縮存檔日志文件來節(jié)省硬盤空間。
當(dāng)你遇到一下情況是,你可以選擇Lumberjack框架:
1.你想找到一種方式來跟蹤在程序中不斷出現(xiàn)的不可復(fù)制的bug;
2.你對iPhone上的簡短日志感到很失望;
3.出于支持系統(tǒng)和穩(wěn)定性的需要,你想將應(yīng)用程序升級到下一級別;
4.為你的應(yīng)用程序(Mac或者iPhone)尋找企業(yè)級的日志解決方案。
如何開始使用Lumberjack框架
開始
三步開始使用CocoaLumberjack框架:
1.將Lumberjack文件添加到你的項目中;
2.配置框架;
3.將NSLog指令轉(zhuǎn)換為使用Lumberjack宏指令;
把Lumberjack框架添加到你的項目
需要添加的主要文件有四個:
[email protected](整個框架的基礎(chǔ))
[email protected](發(fā)送日志語句到蘋果的日志系統(tǒng),以便它們顯示在Console.app上)
[email protected]oyger(發(fā)送日志語句到Xcode控制臺,如果可用)
[email protected](把日志語句發(fā)送至文件)
DDLog是強制性的,其余的都是可選的,這取決于你打算如何使用這個框架。例如,如果你不打算紀(jì)錄到一個文件,你可以跳過DDFileLogger,或者你想跳過ASL以便更快的文件記錄,你可以跳過DDASLLoger。
配置框架
首先,你想要在你的應(yīng)用程序中配置這個日志框架,通常在applicationDidFinishLaunching方法中配置。
開始時,你需要下面兩行代碼:
[DDL
[DDLog addLogger:[DDTTYLogger sharedInstance]];
這將在你的日志框架中添加兩個“logger”。也就是說你的日志語句將被發(fā)送到Console.app和Xcode控制 臺(就像標(biāo)準(zhǔn)的NSLog)
這個框架的好處之一就是它的靈活性,如果你還想要你的日志語句寫入到一個文件中,你可以添加和配置一個file logger:
fileLogger = [[DDFileLogger alloc] init];
fileLogger.rollingFrequency = 60 * 60 * 24; // 24 hour rolling
fileLogger.logFileManager.maximumNumberOfLogFiles = 7;
[DDLog addLogger:fileLogger];
上面的代碼告訴應(yīng)用程序要在系統(tǒng)上保持一周的日志文件。
新聞熱點
疑難解答
圖片精選