GKLogger

GKLogger 是一个基于 Swift 的日志记录工具，旨在通过 CoreData 有效地管理应用程序日志。它允许记录不同严重程度级别（调试、信息、警告和错误）的消息，并支持将日志导出为纯文本文件。 GKLogger 确保日志具有持久性，即使在应用程序重启后也可以检索。

• 日志级别: 支持多个日志级别: .debug, .info, .warning, .error。
• CoreData 集成: 使用托管对象模型 (GKLogs) 将日志存储在 CoreData 中。
• 日志导出: 获取日志并将其导出到 .txt 文件。
• 并发支持: 日志记录操作在后台线程上执行，以提高性能。
• 可自定义的日志限制: 允许设置获取的日志数量的限制。
• OSLog 集成: 与 Apple 的 OSLog 集成，用于系统日志记录。

• 安装
• 用法
  • 记录消息
  • 以数据形式检索日志
  • 将日志导出到文件
  • 配置日志级别

• iOS 14.0+ / macOS 11+ / tvOS 12.0+

• Xcode 11.0+

• Swift 5.0+

  通过 Swift Package Manager (SPM) 安装 GKLogger 的说明

您可以通过以下步骤使用 Swift Package Manager (SPM) 将 GKLogger 添加到您的项目中

1. 打开您的 Xcode 项目。
2. 在 Xcode 项目导航器中选择您的项目。
3. 在项目编辑器中，选择 Package Dependencies（包依赖项）选项卡。
4. 单击包列表底部的 + 按钮。
5. 在出现的对话框中，输入仓库 URL

https://github.com/GeorgeKyrylenko1998/GKLogger

6. 选择您要使用的版本或分支

   • 如果您希望收到不包含重大更改的更新，请使用 Up to Next Major Version（高达下一个主版本）规则。
   • 如果您需要特定版本，请使用 Exact Version（确切版本）。
   • 您还可以选择一个特定的分支，例如 main。

7. 单击 Add Package（添加包）。

使用各种日志级别记录消息

GKLogger.log("This is a debug message", type: .debug)
GKLogger.log("An error occurred while saving", type: .error)

您可以将存储的日志以 UTF-8 格式检索为 Data 对象

if let logsData = GKLogger.logsData {
    // Use the logsData here, e.g., save to a file or upload
}

您还可以通过调整 logsLimit 来设置要检索的最大日志数

GKLogger.logsLimit = 10000

您可以将日志导出为 .txt 文件

GKLogger.logsURL { fileURL in
    guard let fileURL = fileURL else { return }
    // Use the file URL to share or save the file
}

默认情况下，日志级别设置为 .debug。您可以调整日志级别，以便仅记录指定级别或更高级别的消息。

GKLogger.logLevel = .warning

在此示例中，只会记录级别为 .warning 及更高级别的消息（例如，.error）。

由 George Kyrylenko 创建于 2024.09.09