SwifterLog

一个 Swift 框架，用于创建和管理最多 5 个目标和 8 个级别的日志条目。

SwifterLog 是 Swiftfire 网络服务器项目的一部分。

Swiftfire 网站

参考手册

安装手册在 Swiftfire.nl 或 github 上

用户手册在 Swiftfire.nl 或 github 上

功能特性

5 种不同的日志记录目标
1. OS Log 工具（来自 macOS 10.12 或 iOS 10）
2. 一个文件
3. STDOUT (println)
4. 一个网络目标
5. 来自应用程序本身的回调对象列表。
8 个日志级别
1. Debug (调试)
2. Info (信息)
3. Notice (注意)
4. Warning (警告)
5. Error (错误)
6. Critical (严重)
7. Alert (警报)
8. Emergency (紧急)
每个日志记录目标都可以有自己的信息记录截止级别。
文件目标可以配置为将日志信息存储在预定义最大大小的预定义数量的文件中。当超过最大文件数时，最旧的文件将自动删除。
包含高性能非评估目标，允许调试日志调用保留在发布代码中
使用 SPM (Swift Package Manager) 编译
可以进行过滤
支持 macOS 和 Linux
如果同一应用程序的多个实例并行执行，则保持日志文件分离。

安装

作为 SPM 包

要安装 SwifterLog，请输入以下命令

$ git clone https://github.com/Balancingrock/SwifterLog

这将创建一个名为 SwifterLog 的目录，其中包含该项目。

进入创建的目录

$ cd SwifterLog

然后执行 SPM 构建。

$ swift build

添加到 Xcode 项目

在使用导航器面板的 Xcode 项目中，选择应将 SwifterLog 添加到的目标。

然后选择 General 选项卡，然后单击 Frameworks, Libraries, and Embedded Content 部分的 + 符号。

在下拉窗口中，选择 Add Other... 并选择 Add Package Dependency...。

在新下拉窗口中，键入 https://github.com/Balancingrock/SwifterLog.git，然后单击 Next、Next 和 Finish。

现在在每个需要其功能的源文件中使用 import SwifterLog。

可选删除 Ascii、BRUtils、VJson 和 SwifterSockets 依赖项

默认情况下，SwifterLog 也需要 Ascii、BRUtils、VJson 和 SwifterSockets 用于网络目标。如果不需要网络目标，则可以通过添加活动编译条件来排除该代码

在 Xcode 项目中，SwifterLog 框架目标，选择 Build Settings，然后在 Swift Compiler - Custom Flags 下，将 SWIFTERLOG_DISABLE_NETWORK_TARGET 添加到 Active Compiler Conditions。

还要从 SwifterLog 目标的 General 选项卡下的 Linked Frameworks and Libraries 设置中删除 Ascii、BRUtils、VJson 和 SwifterSockets。

版本历史

没有新的功能计划。更新会根据需要进行临时更新，以支持 Swiftfire 开发。

2.2.2 & 2.2.3

添加了 swift 版本、平台和 LICENSE 文件

2.2.1

重写了对 >= macOS 12 的依赖

2.2.0

添加了并行运行应用程序的多个实例并仍然保持日志文件分离的功能。

2.1.1

Linux 兼容性

2.1.0

针对 SwifterSockets 中的更改进行了更新：使用 Swift.Result 而不是 BRUtils.Result。

2.0.1

文档更新

2.0.0

更新了标头
添加了 defaultTypeString，现在允许空的类型参数。

1.7.1

更新了 manifest 到 tool v5
将平台添加到 manifest (macOS 10.12)

1.7.0

迁移到 Swift 5

1.6.0

撤消了在 Stdout 目标中禁用时间信息的做法（不需要）
修复了级别反转错误，该错误使最新版本的 SwifterLog 无法工作

1.5.0

向 Stdout 目标添加了禁用时间信息的功能
为 OSLog 目标添加了禁用/启用设置

1.4.0

使 message 参数成为隐式参数

1.3.0

将 ASL 替换为 os_log

1.2.0

迁移到 SPM 4

1.1.2

迁移到 Swift 4， minor changes (小改动)。
更新了用户手册

1.1.1

更新了依赖项

1.1.0

从 1.0.1 分支出来，新的实现。

1.0.1

更新了依赖项 (VJson & SwifterSockets)

1.0.0

自上一个版本以来，除了此自述文件外，没有其他更改。