JJSwiftLog高性能自定义日志

最新推荐文章于 2025-06-24 13:33:53 发布

lijie250

最新推荐文章于 2025-06-24 13:33:53 发布

阅读量273

点赞数 1

CC 4.0 BY-SA版权

分类专栏： log 文章标签： ios swift logging

本文链接：https://blog.youkuaiyun.com/lijie250/article/details/105429446

log 专栏收录该内容

2 篇文章

订阅专栏

JJSwiftLog是一个基于Swift的高性能日志库，利用Unix file descriptor的stdout原理实现。它提供控制台展示、日志文件存储功能，并允许用户自定义日志行为和格式。通过Podfile、Carthage或Swift Package Manager进行安装，支持全局日志开关、指定文件日志显示及自定义日志格式。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

使用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) {
    }
    
}

https://github.com/jezzmemo/JJSwiftLog