NoveLogger
这是一个简单的 Swift 日志工具,在 Debug 模式下使用 print
,在生产模式下使用 NSLog
。
特点
- 在 Debug 模式下使用
print
,在生产模式下使用NSLog
。 - 格式化 Debug 模式和生产模式的输出。
- 支持日志级别
- 包含日志的日期、日志级别、文件、行和调用函数。
- 已进行单元测试。
需求
- iOS 9.0+
- Mac OS X 10.15+
- WatchOS 2.0+
- TV OS 9.0+
安装
NoveLogger 使用 CocoaPods。它是 Cocoa 项目的依赖管理器。
要使用 CocoaPods 将 NoveLogger 集成到您的 Xcode 项目中,请在您的 Podfile 中指定它
source 'https://github.com/CocoaPods/Specs.git'
use_frameworks!
pod 'NoveLogger', '~> 1.0'
然后,请运行以下命令
$ pod install
使用方法
基础知识
首先导入NoveLogger
import NoveLogger
您有3种方法来记录日志
// Using static functions (it will use the default logger)
NoveLogger.verbose("Your log message")
// Using the default logger
NoveLogger.defaultLogger.verbose("Your log message")
// Using an instanciated logger
let logger = NoveLogger()
logger.verbose("Your log message")
这里是一个输出示例
2019-12-02 15:25:41.031 [VERBOSE] [NoveLoggerTests.swift:42] testSimpleMessage(): Your log message
日志级别
NoveLogger允许5个日志级别
NoveLogger.verbose("Verbose log.")
NoveLogger.debug("Debug log.")
NoveLogger.info("Info log.")
NoveLogger.warning("Warning log.")
NoveLogger.error("Error log.")
如果日志级别低于在日志记录器中定义的级别,则不会输出日志。
let logger = NoveLogger()
logger.logLevel = .info
logger.verbose("This message will not be printed.")
logger.error("This message will be printed.")
设置你的日志记录器的日志级别时,您可以设置,从低到高
.all // Everything will be printed.
.verbose
.debug
.info
.warning
.error
.off // Nothing will be printed.
默认情况下,日志级别在Debug中设置为.all
,在生产环境中为.warning
。
您可以通过调用(例如)来覆盖默认的日志记录器级别
NoveLogger.defaultLogger.logLevel = .debug
格式
您可以使用格式将内容包含到日志中
NoveLogger.verbose("Here is a message containing %d %@.", args: 2, "arguments")
> 2019-12-02 15:25:40.023 [VERBOSE] [NoveLoggerTests.swift:51] testFormat(): Here is a message containing 2 arguments.
致谢
许可证
NoveLogger在MIT许可证下提供。有关更多信息,请参阅LICENSE文件。