JJSwiftLog
JJSwiftLog screenshot
使用Unix file descriptor的stdout原理,将日志模块的日志输出到stdout,然后将日志抽象成接口,内置控制台和文件日志,由开发者自行添加,自定义日志可以满足自行分发到任意渠道.
主要功能
控制台展示(Console Log)
日志文件存储(File Log)
用户自定义日志,实现JJLogOutput协议即可
全局开关日志
只显示指定文件日志
自定义日志格式, 内置样式供开发者选择
如何安装
Swift 4.0+
Podfile
pod 'JJSwiftLog'
Carthage
github "jezzmemo/JJSwiftLog"
Swift Package Manager
.package(url: "https://github.com/jezzmemo/JJSwiftLog.git"),
如何使用
导入模块
import JJSwiftLog
使用示例,setup必须的
func setupLog() {
if let file = JJFileOutput() {
jjLogger.addLogOutput(file)
}
#if DEBUG
jjLogger.addLogOutput(JJConsoleOutput())
#endif
}
override func viewDidLoad() {
super.viewDidLoad()
setupLog()
jjLogger.verbose("verbose")
jjLogger.debug("debug")
jjLogger.info("info")
jjLogger.warning("warn")
jjLogger.error("error")
}
使用enable,实时开关日志,默认是开启的
jjLogger.enable = true
使用onlyLogFile方法,让指定文件显示日志
jjLogger.onlyLogFile("ViewController")
JJSwiftLog支持自定义格式日志,以下表格是简写字母对应关系:
简写
描述
%M
日志文本
%L
日志级别
%l
行数
%F
文件名
%f
函数名
%D
日期(目前仅支持yyyy-MM-dd HH:mm:ss.SSSZ)
%T
线程,如果主线程不显示,子线程显示地址
代码示例:
jjLogger.format = "%M %F %L%l %f %D"
还内置了一些样式,如:jjLogger.format = JJSwiftLog.simpleFormat,样式如下:
2020-04-08 22:56:54.888+0800 -> ViewController:18 - setupVendor(parameter:) method set the parameter
2020-04-08 22:56:54.889+0800 -> ViewController:28 - viewDidLoad() Start the record
2020-04-08 22:56:54.889+0800 -> ViewController:29 - viewDidLoad() Debug the world
2020-04-08 22:56:54.890+0800 -> ViewController:30 - viewDidLoad() Show log info
2020-04-08 22:56:54.890+0800 -> ViewController:31 - viewDidLoad() Build warning
2020-04-08 22:56:54.890+0800 -> ViewController:32 - viewDidLoad() can’t fetch user info without user id
高级使用,根据需要实现自定义接口JJLogOutput,示例如下:
public struct CustomerOutput: JJLogOutput {
/// 自定义队列
public var queue: DispatchQueue? {
return nil
}
/// 重写日志的级别
public var logLevel: JJSwiftLog.Level {
get {
return _consoleLevel
}
set {
_consoleLevel = newValue
}
}
/// 获取日志方法
public func log(_ level: JJSwiftLog.Level, msg: String, thread: String,
file: String, function: String, line: Int) {
}
}