NOCLog
NOCLog 是一个非常简单的库,为 Objective-C 项目提供调试时的日志输出。
Xcode 包含了出色的调试工具。它主要使用断点和 lldb 进行调试,但有时也会使用控制台日志进行调试。
NOCLog 是一个非常简单的日志输出库,您可以通过日志级别来确定是否根据日志类型进行输出。
安装
您可以使用 CocoaPods(Objective-C 和 Swift 的项目依赖管理工具)来安装它。
CocoaPods 安装
要将 NOCLog 依赖项注入到您的 Xcode 项目中,使用 CocoaPods,请在 Podfile 中添加 NOCLog。
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
target 'YourProjectName' do
pod 'NOCLog', '~> 0.1'
end
如果您已经使用 Podfile,只需添加 NOCLog 依赖项。
pod 'NOCLog', '~> 0.1'
如果 NOCLog 依赖项已添加到 Podfile,请执行以下命令:
$ pod install
使用方法
是否输出日志由日志类型(NOCLogType
)和日志级别(NOCLogLevel
)决定。
设置日志级别
1. 使用宏定义设置日志级别
可以使用LOGLEVEL
宏定义来指定日志级别。
#define LOGLEVEL 31
#import "NOCLog.h"
注意事项
必须在导入NOCLog库的头文件之前定义
LOGLEVEL
宏。否则,它将设置为默认值(NOCLogLevelWarn
= 3)。
2. 使用预处理器宏设置日志级别
您可以通过在项目的构建设置的“项目设置”下的预处理器宏中指定LOGLEVEL
值来设置日志级别。
LOGLEVEL=31
建议使用预处理器宏,因为您可以为调试和发布环境指定不同的日志级别。
可用的日志级别
日志级别 | NOCLogLevel | 说明 |
---|---|---|
0 |
NOCLogLevelOff |
不输出日志。 |
1 |
NOCLogLevelError |
只输出错误日志。 |
3 |
NOCLogLevelWarn |
输出错误和警告日志。 |
7 |
NOCLogLevelInfo |
输出错误、警告和信息日志。 |
15 |
NOCLogLevelDebug |
输出错误、警告、信息和调试日志。 |
31 |
NOCLogLevelVerbose |
输出所有日志,包括详细日志。 |
日志输出宏函数
宏函数 | 日志类型 | 说明 |
---|---|---|
NOCLogE |
NOCLogTypeError |
用于错误日志输出。 |
NOCLogW |
NOCLogTypeWarn |
用于警告日志输出。 |
NOCLogI |
NOCLogTypeInfo |
用于信息日志输出。 |
NOCLogD |
NOCLogTypeDebug |
用于调试日志输出,以了解执行流程。 |
NOCLogV |
NOCLogTypeVerbose |
用于输出更多信息。 |
示例
您也可以参考演示应用程序。
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
NOCLogD(@"%@%@\n%@%@",
@"application : ", application,
@"launchOptions: ", launchOptions);
NOCLogE(@"%@", @"Error Message!");
NOCLogW(@"%@", @"Warning Message!");
NOCLogI(@"%@", @"Information Message!");
NOCLogV(@"%@", @"Verbose Message!");
return YES;
}
如果您添加如上日志输出代码并运行应用程序,它将如下输出到控制台。
上述示例是在将日志级别(LOGLEVEL
)设置为31或更高值时。
如果未指定日志级别(LOGLEVEL
)(默认:3
),则只有使用NOCLogE
和NOCLogW
的日志会被输出到控制台。
许可证
NOCLog是在MIT许可证下发布的。有关详细信息,请参阅LICENSE。