SimpleLogger

SimpleLogger 是一款强大且灵活的日志框架，专为跨多个平台的 Swift 应用程序而设计，包括 iOS、macOS、tvOS 和 watchOS。它为轻松精确地管理、过滤和导出日志提供了广泛的功能。

• 跨平台支持： 在 UIKit 和 AppKit 之间统一的日志记录接口。
• 灵活的日志管理： 使用高级过滤选项管理日志条目，包括特定日期、日期范围、小时范围和预设间隔。
• 可自定义的日志级别： 通过额外的类别扩展和自定义日志级别，以实现精确的日志记录。
• 导出选项： 以纯文本、JSON 或 CSV 格式导出日志，并可配置分隔符。

使用 Swift Package Manager 将 SimpleLogger 添加到您的 Swift 项目中。

dependencies: [
  .package(url: "https://github.com/markbattistella/SimpleLogger", from: "1.0.0")
]

或者，您可以使用 Xcode 添加 SimpleLogger，方法是导航到 File > Add Packages 并输入软件包仓库 URL。

SimpleLogger 的简单之处在于它有一个便捷的初始化器，它使用应用程序的内部 BundleIdentifier 作为子系统，并拥有 89 个预定义的常用类别。

使用 SimpleLogger 进行通用日志记录非常简单，只需

// Create a logger instance with a specific category
let logger = Logger(category: .ui)

// Log an informational message
logger.info("User tapped the start button")

SimpleLogger 包含预定义的类别，以帮助更有效地组织和过滤日志。以下是可用类别的表格

LoggerCategory 结构体允许用户通过简单地扩展该结构体并定义一个新类别来创建自己的类型安全的类别。

如果存在重复的类别（新的类别与预定义的类别匹配，或重复的自定义类别），软件包将记录警告以通知您。

extension LoggerCategory {
  static let myCustomCategory = LoggerCategory("MyCustomCategory")
}

// Using the custom category
let logger = Logger(category: .myCustomCategory)

要在您的 SwiftUI 应用程序中初始化 LoggerManager，请创建它的一个实例，并指定其参数以根据您的需求定制日志记录行为

import SwiftUI
import SimpleLogger

@main
struct MyApp: App {
    @StateObject private var loggerManager = LoggerManager(
        excludeSystemLogs: true, 
        filterType: .all, 
        logLevels: [.info, .error]
    )

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environmentObject(loggerManager)
        }
    }
}

LoggerManager 支持各种过滤选项

• 特定日期： 过滤特定日期的日志。
• 日期范围： 过滤两个日期之间的日志。
• 小时范围： 过滤一天中特定小时内的日志。
• 预设： 使用预定义的时间间隔来过滤日志。

以不同的格式导出日志

• 纯文本： 可读格式，条目按行分隔。
• JSON： 用于与其他系统集成的结构化数据格式。
• CSV： 逗号分隔值，带有可自定义的分隔符。

为 CSV 导出定义自定义分隔符以确保数据完整性

let customCSV = loggerManager.exportLogs(as: .csv(.semicolon))

欢迎贡献！请 Fork 仓库并提交 Pull Request 以进行任何功能、修复或改进。

SimpleLogger 在 MIT 许可证下可用。有关更多信息，请参阅 LICENSE 文件。