NoveLogger 1.0.0

NoveLogger 1.0.0

Steve Gigou 维护。



NoveLogger

Version License Platform

这是一个简单的 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.

致谢

Steve Gigou (网站, Twitter)

许可证

NoveLogger在MIT许可证下提供。有关更多信息,请参阅LICENSE文件。