1. CocoaLumberjack这个框架是做什么的?
CocoaLumberjack是Mac和iOS上一个集快捷、简单、强大和灵活于一身的日志框架。CocoaLumberjack类似于流行 的日志框架(如log4j),但它是专为Objective-C设计的,利用了多线程、GCD(如果可用)、无锁原子操作Objective-C运行时的 动态特性。
框架图:
2. CocoaLumberjack 它的优点有哪些?
快速
在大多数用例中,Lumberjack比NSLog快了一个数量级。
简单
当应用程序启动时,只需一行加单的代码就可配置Lumberjack。然后用DDLog语句简单地取代NSLog语句,使用方法与NSLog完全一样
灵活性
配置你自己想要的日志框架。修改每个文件的日志级别(尤其是测试时)。修改每个logger的日志级 别(详细的控制台,但是简洁的日志文件)。修改每个Xcode配置的日志级别。为你的应用程序定制日志级别的数量。添加自己的精细的日志。在运行时动态修 改日志级别。 选择如何以及何时回滚你的日志文件。将日志文件上传至中心服务器。压缩存档日志文件来节省硬盘空间,一个日志语句可以被发送到多个logger,意味着你可以同时记录文件和控制台。此外,还可以创建自己的logger,将日志语句发送到网络、数据库或者分布式文件系统中,日志保存方法十分灵活。
1.跟踪在程序中不断出现的不可复制的bug;
2.对原声的系统日志感到失望
3.出于支持系统和稳定性的需要,你想将应用程序升级到下一级别;
4.为你的应用程序(Mac或者iPhone)寻找企业级的日志解决方案。
5. 自定义日志级别,查看对应安全级别的日志。
1.配置
CocoaPods
platform:ios,'8.0'pod'CocoaLumberjack'
Cartfile
github "CocoaLumberjack/CocoaLumberjack"
2.第二种配置放方法是直接“拖拽”进工程。添加文件。
5. 现在在你的pch文件中 加上 #import ,编译项目,应该是成功了。
2. CocoaLumberjack的详细使用。
1.如果想要支持彩色日志效果,这儿需要用 package manager 装上XcodeColors这个插件。
2.认识下面几个常用的类
1.DDLog(整个框架的基础)
2.DDASLLogger(发送日志语句到苹果的日志系统,以便它们显示在Console.app上)
3.DDTTYLoyger(发送日志语句到Xcode控制台,如果可用)
4.DDFIleLoger(把日志语句发送至文件)
DDLog是强制性的,其余的都是可选的,这取决于你打算如何使用这个框架。例如,如果你不打算纪录到一个文件,你可以跳过DDFileLogger,或者你想跳过ASL以便更快的文件记录,你可以跳过DDASLLoger。
3. 开始在程序中进行设置。
[objc]view plaincopy
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.
[DDLog addLogger:[DDASLLogger sharedInstance]];
[DDLog addLogger:[DDTTYLogger sharedInstance]];
return YES;
}
在程序最开始的运行的地方就进行一个log的初始化, 这样做的作用就是在你的日志框架中添加两个“logger”。也就是说你的日志语句将被发送到Console.app和Xcode控制 台(就像标准的NSLog)
如果你需要把这些日志添加到文件中,那么这个时候你就用到了DDFIleLoger。使用方法如下
[objc]view plaincopy
DDFileLogger *fileLogger = [[DDFileLogger alloc] init];
//保存周期
fileLogger.rollingFrequency = 660 * 660 * 24; // 24 hour rolling
//最大的日志文件数量
fileLogger.logFileManager.maximumNumberOfLogFiles = 7;
[DDLog addLogger:fileLogger];
4. 最重要的部分。用DDLog替换NSLog语句
DDLog的输出级别默认提供以下若干种:
DDLogError:定义输出错误文本
DDLogWarn:定义输出警告文本
DDLogInfo:定义输出信息文本
DDLogDebug:定义输出调试文本
DDLogVerbose:定义输出详细文本
提供的日志级别为:
LOG_LEVEL_ERROR:只显示错误日志。
LOG_LEVEL_WARN:包括:LOG_LEVEL_ERROR
LOG_LEVEL_INFO:包括:LOG_LEVEL_WARN
LOG_LEVEL_DEBUG:包括:LOG_LEVEL_INFO
LOG_LEVEL_VERBOSE:包括:LOG_LEVEL_DEBUG
LOG_LEVEL_OFF:关闭日志
以上简单使用。
=============================================================================================
The last:(自己根据自己的项目简单的再封装)
#ifdef DEBUG // 调试状态
// 打开LOG功能
#define OKAY_LOG(fmt, ...) do { \
NSString* file = [[NSString alloc] initWithFormat:@"%s", __FILE__]; \
DDLogError((@"%@(%s)(line:%d) " fmt), [file lastPathComponent], __PRETTY_FUNCTION__, __LINE__, ##__VA_ARGS__); \
file = nil; \
} while(0)
#else // 发布状态
// 关闭LOG功能
#define DDLogError(...)
#endif