NOCLog 1.0.0

NOCLog 1.0.0

测试已测试
语言编程语言 Obj-CObjective C
许可证 MIT
发布最新发布2018年3月

Jaeo Bok维护。



NOCLog 1.0.0

NOCLog

Build Status Version Platform License Twitter

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

Set the log level using preprocessor macro

建议使用预处理器宏,因为您可以为调试和发布环境指定不同的日志级别。

可用的日志级别

日志级别 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;
}

如果您添加如上日志输出代码并运行应用程序,它将如下输出到控制台。

Sample log output

上述示例是在将日志级别(LOGLEVEL)设置为31或更高值时。

如果未指定日志级别(LOGLEVEL)(默认:3),则只有使用NOCLogENOCLogW的日志会被输出到控制台。

许可证

NOCLog是在MIT许可证下发布的。有关详细信息,请参阅LICENSE