https://github.com/zjinhu/swiftlog
swift砖块系列：Swift Log输出工具，可分级别打印log，方便排查日志，添加unicode转码，持续输出中文，支持swift4以上，支持log到本地文件中，添加淘汰算法默认七天淘汰一次log日志文件
https://github.com/zjinhu/swiftlog
log print swift swift4 swift5
Last synced: about 1 year ago
JSON representation
swift砖块系列：Swift Log输出工具，可分级别打印log，方便排查日志，添加unicode转码，持续输出中文，支持swift4以上，支持log到本地文件中，添加淘汰算法默认七天淘汰一次log日志文件
- Host: GitHub
- URL: https://github.com/zjinhu/swiftlog
- Owner: zjinhu
- License: mit
- Created: 2020-04-02T08:56:59.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-01-16T01:36:50.000Z (over 2 years ago)
- Last Synced: 2025-03-24T01:22:54.887Z (about 1 year ago)
- Topics: log, print, swift, swift4, swift5
- Language: Swift
- Homepage:
- Size: 142 KB
- Stars: 25
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](http://cocoapods.org/pods/Swift_Log)
[](https://swift.org/package-manager/)
[](https://developer.apple.com/swift/)
Swift 日志分级打印工具。
支持分不同等级打印log，添加不同emoji方便查阅对应等级，可以设置输出级别，低于该级别的日志不进行打印。
添加专门用于打印网络请求报文的类型unicode转码，方便查看中文日志输出。
支持打印日志到文件，提供文件路径方便上传日志文件，支持文件LRU淘汰，默认七天淘汰一次。用法详见Demo。
尝试了xs max下异步并发的方式写入100条4000字的日志大概需要170毫秒，不写文件仅仅Xcode的日志输出需要150毫秒。FileManager是线程安全的可以放心使用。
## 安装
### cocoapods
1.在 Podfile 中添加 `pod ‘Swift_Log’`
2.执行 `pod install 或 pod update`
3.导入 `import Swift_Log`
### Swift Package Manager
从 Xcode 11 开始，集成了 Swift Package Manager，使用起来非常方便。SwiftLog 也支持通过 Swift Package Manager 集成。
在 Xcode 的菜单栏中选择 `File > Swift Packages > Add Pacakage Dependency`，然后在搜索栏输入
`https://github.com/jackiehu/SwiftLog`，即可完成集成
### 手动集成
SwiftLog 也支持手动集成，只需把Sources文件夹中的SwiftLog文件夹拖进需要集成的项目即可
## 使用
```swift
/// log等级
public enum LogDegree : Int{
case verbose = 0//最低级log
case debug = 1//debug级别
case netWork = 2//用于打印网络报文，可单独关闭
case info = 3//重要信息级别
case warning = 4//警告级别
case error = 5//错误级别
}
```
```swift
// 设置默认打印Log的等级。低于此等级不做输出
SLog.defaultLogDegree = .debug
// 用于网络日志的开关
SLog.showNetLog = false
//缓存日志保存最长时间///如果需要自定义时间一定要在addFileLog之前 默认七天
SLog.maxLogAge = 60 * 60 * 24 * 7
// 打印日志到文件中
SLog.addFileLog = true
//获取文件地址URL
SLog.getLogFileURL
```
输出日志
```swift
SLogVerbose("打印最低级信息可忽视不理会")
SLogDebug("打印Debug级信息")
//支持打印时unicode转中文
SLogNet("可单独关闭----\\u6253\\u5370\\u6d88\\u606f print message，可以用于打印类似网络请求报文")
SLogInfo("打印Info级信息")
SLogWarn("打印警告级信息")
SLogError("打印Error信息")
```
也可以使用这种方法打印
```swift
SLog.verbose("ignore")
SLog.debug("debug")
SLog.net("netWork")
SLog.info("info")
SLog.warn("warning")
SLog.error("error")
```
打印输出样式，防止其他输出干扰
```
🌐 Network 🌐 | 2021-03-05 15:27:33:609
所在类:ViewController.swift
方法名:viewDidLoad()
所在行:31
<<<<<<<<<<<<<<<<信息>>>>>>>>>>>>>>>>
netWork
<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>
```
```
🔔 Info 🔔 | 2021-03-05 15:27:33:614
所在类:ViewController.swift
方法名:viewDidLoad()
所在行:35
<<<<<<<<<<<<<<<<信息>>>>>>>>>>>>>>>>
info
<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>
```
```
⚠️ Warning ⚠️ | 2021-03-05 15:27:33:615
所在类:ViewController.swift
方法名:viewDidLoad()
所在行:38
<<<<<<<<<<<<<<<<信息>>>>>>>>>>>>>>>>
warning
<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>
```
```
❌ Error ❌ | 2021-03-05 15:27:33:616
所在类:ViewController.swift
方法名:viewDidLoad()
所在行:41
<<<<<<<<<<<<<<<<信息>>>>>>>>>>>>>>>>
error
<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>
```
```
✅ Debug ✅ | 2021-03-05 15:36:57:508
所在类:ViewController.swift
方法名:viewDidLoad()
所在行:28
<<<<<<<<<<<<<<<<信息>>>>>>>>>>>>>>>>
debug
<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>
```
```
⚪ Verbose ⚪ | 2021-03-05 15:36:57:505
所在类:ViewController.swift
方法名:viewDidLoad()
所在行:25
<<<<<<<<<<<<<<<<信息>>>>>>>>>>>>>>>>
ignore
<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>
```
详细用法参见Demo **ViewController**
## 更多砖块工具加速APP开发
[](https://github.com/jackiehu/SwiftBrick)
[](https://github.com/jackiehu/SwiftMediator)
[](https://github.com/jackiehu/SwiftShow)
[](https://github.com/jackiehu/SwiftyForm)
[](https://github.com/jackiehu/SwiftEmptyData)
[](https://github.com/jackiehu/SwiftPageView)
[](https://github.com/jackiehu/JHTabBarController)
[](https://github.com/jackiehu/SwiftMesh)
[](https://github.com/jackiehu/SwiftNotification)
[](https://github.com/jackiehu/SwiftNetSwitch)
[](https://github.com/jackiehu/SwiftButton)
[](https://github.com/jackiehu/SwiftDatePicker)