LoggerAPI

这是一种提供不同类型日志记录器通用日志接口的日志协议协议。此外，还提供了一个具有一组静态函数的类，用于在您的代码中进行日志记录。

Kitura 使用此 API 在其实施过程中进行日志记录。

使用方法

添加依赖

将 LoggerAPI 包添加到应用程序 Package.swift 文件中的依赖项内。将 "x.x.x" 替换为最新的 LoggerAPI 版本

.package(url: "https://github.com/Kitura/LoggerAPI.git", from: "x.x.x")

将 LoggerAPI 添加到您的目标依赖项中

.target(name: "example", dependencies: ["LoggerAPI"]),

导入包

import LoggerAPI

日志消息

将日志消息添加到您的应用

Log.warning("This is a warning.")
Log.error("This is an error.")

定义一个记录器

您需要定义一个 logger 来输出这些消息。您可以选择实现自己的 Logger，或者使用将消息写入标准输出的 HeliumLogger

import LoggerAPI
import HeliumLogger

let myLogger = HeliumLogger(.info)
Log.logger = myLogger

您可以在这里了解更多关于 HeliumLogger 的信息。

将日志消息记录到swift-log

您可以将日志消息通过设置 swiftLogger 属性直接指向 swift-log

import LoggerAPI
import Logging

let myLogger = Logging.Logger(label: "myLogger")
myLogger.logLevel = .notice
Log.swiftLogger = myLogger

如果同时设置了 logger 和 swiftLogger，则日志消息将发送到两个日志后端。LoggerAPI 日志记录器和 swift-log 日志记录器的日志级别配置是独立的，因此可以用于记录不同级别的日志。

请注意，由于 LoggerAPI 和 swift-log 定义的日志级别层次结构略有不同，因此定义了级别之间的映射。有关详细信息，请参阅 Log.isLogging() 的文档。

API 文档

有关更多信息，请访问我们的API 参考。

社区

我们都喜欢讨论服务器端 Swift 和 Kitura。加入我们的Slack，认识我们的团队吧！

许可协议

该库遵循Apache 2.0许可证。完整的许可协议文档可在LICENSE中查看。