JJSwiftLog
JJSwiftLog screenshot
使用Unix file descriptor的stdout原理，将日志?？榈娜罩臼涑龅絪tdout,然后将日志抽象成接口，内置控制台和文件日志，由开发者自行添加，自定义日志可以满足自行分发到任意渠道.
主要功能
控制台展示(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"),
如何使用
- 导入?？?/li>
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) {
}
}
