SwiftyBeaver Swift 项目的彩色日志库

SwiftyBeaver: Swift 项目的彩色日志库

SwiftyBeaver 是一个轻量级的 Swift 日志库，获得了 6,000+ Star：

它支持 Swift 3、4、5 三个版本，提供彩色日志输出。开发阶段可以在 Xcode 控制台快速定位日志，生产环境则可以把日志写入文件或云端。

日志输出目标

SwiftyBeaver 支持三种输出方式：

• Console：在 Xcode 控制台输出彩色日志，Xcode 15 可通过 OSLog API 实现
• File：将日志写入本地文件，适合长期存储或终端爱好者
• Cloud：支持 Google Cloud 等云端日志服务，可自定义日志格式并转为 JSON

日志分为 VERBOSE、DEBUG、INFO、WARNING、ERROR 五个级别，每个级别用不同颜色区分。

快速上手

安装支持 Carthage、Swift Package Manager 和 CocoaPods 三种方式。以 SPM 为例，在 Package.swift 中添加依赖：

.package(url: "https://github.com/SwiftyBeaver/SwiftyBeaver.git", .upToNextMajor(from: "2.0.0")),

项目中使用只需几行代码：

import SwiftyBeaver let log = SwiftyBeaver.self let console = ConsoleDestination() console.format = "$DHH:mm:ss$d $L $M" log.addDestination(console) log.verbose("not so important") log.debug("something to debug") log.info("a nice information") log.warning("oh no, that won't be good") log.error("ouch, an error did occur!")

日志格式支持自定义，设置console.format = "$J"可切换为 JSON 输出。SwiftUI 项目也可以直接在 App 的 init 中配置。

服务端支持

SwiftyBeaver 对服务端 Swift 提供开箱即用的支持，可以在 Ubuntu Docker 容器中运行和测试。配合 Vapor 框架使用时，有专门的日志适配组件可用。

版本与安装

根据 Swift 版本选择对应的安装方式。Swift 4 及以上使用最新版，Swift 3 需指定 1.8.4 版本，Swift 2 使用 0.7.0。项目采用 MIT 协议开源。

及以上使用最新版，Swift 3 需指定 1.8.4 版本，Swift 2 使用 0.7.0。项目采用 MIT 协议开源。