Android-style d()/i()/w()/e() logging with tag-first design, zero-configuration, coroutine-safe and thread-safe; composable loggers (combine), easy custom implementations and straightforward Java interoperability.
A Kotlin Multiplatform (KMP) logging library that lets you write once, log everywhere — with full support for Android, iOS, JVM, and JavaScript, using a familiar Android-style API (d(), i(), w(), e()).
It supports lazy logging, log composition, tag-based filtering, and level control — all while requiring no platform-specific code and no build-time code generation. Just shared Kotlin that works out of the box.
Logger is designed first and foremost for Kotlin Multiplatform (KMP), so you can write logging code in commonMain and have it work identically across Android, iOS, JVM, and JavaScript.
But you don’t need KMP to benefit! It also works perfectly as a standalone logging library in pure Android, iOS, JVM, or Spring Boot projects — with zero extra setup.
Logger.i("Network", "Request sent")
Logger.e("Auth", "Login failed", exception)
Familiar Android-style API: tag-first, concise methods (d(), i(), w(), e()). Android developers can adopt it instantly — no learning curve.
Skip expensive message construction when logs are disabled — with clean, idiomatic syntax:
Logger.d("Heavy") { "Only evaluated if enabled: ${expensiveCall()}" }
Logger.w("IO") { "Read failed" with ioException }
Zero runtime cost when disabled. Full expressiveness when enabled.
Build your logger like you’d write an arithmetic expression — intuitive and expressive:
// Add destinations (+): multi-channel output
Logger.default = Logger.SYSTEM + FileLogger("app.log") + RemoteLogger
// Remove components (−): exclude a channel
val offline = Logger.default - RemoteLogger
// Combine filters (logical AND): stricter filtering by stacking rules
val policy = LevelFilter.atLeast(WARN) + TagFilter.include("Security")
val secureLogger = Logger.withFilter(policy)
secureLogger.w("Security", "Suspicious activity")
All results are standard
LoggerorFilterinstances — fully composable, just like numbers.
In your shared module (build.gradle.kts):
dependencies {
implementation("io.github.scarlet-pan:logger:1.2.0")
}
This enables logging on all declared targets (Android, iOS, JVM, JS).
implementation("io.github.scarlet-pan:logger-android:1.2.0")
Behaves exactly like android.util.Log with full Logcat integration.
Add via CocoaPods (Podfile):
pod 'KmpLogger', :git => 'https://github.com/scarlet-pen/logger.git', :tag => '1.2.0'
Logs appear in Xcode console automatically. For a more native Swift experience, we recommend adding Loggers.swift.
For standard JVM apps:
implementation("io.github.scarlet-pan:logger-jvm:1.2.0")
If you’re using SLF4J (e.g., Spring Boot), prefer the bridge:
implementation("io.github.scarlet-pan:logger-slf4j:1.2.0")
Then set Logger.default = Slf4jLogger() at startup.
⚠️ The base
loggerartifact is KMP-only. Use platform-specific artifacts (-android,-jvm, etc.) for non-KMP projects.
🔧 Requirements
- Kotlin ≥ 1.9.0
- Android minSdk ≥ 21
- iOS deployment target ≥ 12.0
import dev.scarlet.logger.Logger
Logger.d("Network", "Request sent")
Logger.i("DB", "Query succeeded")
Logger.w("Cache", "Stale data used")
Logger.e("Auth", "Login failed", exception)
Works unchanged in commonMain, androidMain, jvmMain, or iosMain.
Kotlin logs appear via print. For better Swift integration, add Loggers.swift:
SharedLogger.i("Network", "Request sent")
SharedLogger.e("Database", "Failed to open", error: dbError)
Optional but recommended for production iOS apps.
import dev.scarlet.logger.DefaultLogger;
DefaultLogger.d("Service", "Task started");
DefaultLogger.e("DB", "Connection lost", exception);
Logger.d("Debug") { "Expensive debug info: ${computeHeavyData()}" }
Logger.w("IO") { "Read failed" with ioException }
Lambda only invoked if log level is enabled — truly zero overhead.
val debugLogger = Logger.withFilter(Filter.ALL)
debugLogger.d("FeatureX") { "Dev-only log" }
Filter.default = Filter.atLeast(INFO) // DEBUG logs are skipped
Logger.default = Logger.SYSTEM + FileLogger("app.log")
val offline = Logger.default - RemoteLogger
val policy = LevelFilter.atLeast(WARN) + TagFilter.include("Security")
val secureLogger = Logger.withFilter(policy)
secureLogger.w("Security", "Suspicious activity")
All results are standard Logger or Filter instances — fully composable.
Throwable with automatic stack traceLogger.d { "Expensive debug info" })| Platform | Backend |
|---|---|
| Android |
Contributions welcome! See CONTRIBUTING.md.
MIT License – see LICENSE.
Copyright © 2025 Scarlet Pan
—— 中文文档 Chinese Documentation ——
一个 Kotlin 多平台（Kotlin Multiplatform, KMP） 日志库，让你 一次编写，处处打日志 —— 完整支持 Android、iOS、JVM 和 JavaScript，并提供熟悉的 Android 风格 API（d()、i()、w()、e()）。
它支持 惰性日志、日志组合、基于标签的过滤 和 日志级别控制，同时 无需平台专属代码、无需编译期代码生成。只需一份共享 Kotlin，开箱即用。
Logger 首先为 Kotlin 多平台（KMP）而设计，让你在 commonMain 中写一次日志代码，即可在 Android、iOS、JVM 和 JavaScript 上行为完全一致。
但即使你不用 KMP，它同样出色！Logger 也可以作为独立日志库，直接用于纯 Android、纯 iOS、纯 JVM（包括 Spring Boot）等项目 —— 无需额外配置。
Logger.i("Network", "请求已发送")
Logger.e("Auth", "登录失败", exception)
完全沿用 Android 的日志风格：标签优先、方法简洁（d()/i()/w()/e()），Android 开发者几乎无需学习成本，开箱即用。
当日志被禁用时，自动跳过昂贵的消息构造，语法简洁，性能无损：
Logger.d("Heavy") { "仅在启用时执行：${expensiveCall()}" }
Logger.w("IO") { "读取失败" with ioException }
禁用时零运行时开销，启用时表达力十足。
把日志系统当作算式来写 —— 就像做加减乘除一样直观：
// 添加日志目标（加法 +）：多路输出
Logger.default = Logger.SYSTEM + FileLogger("app.log") + RemoteLogger
// 移除组件（减法 −）：剔除某一路输出
val offline = Logger.default - RemoteLogger
// 叠加过滤规则（逻辑 AND）：同时满足多个条件，筛选更严格
val policy = LevelFilter.atLeast(WARN) + TagFilter.include("Security")
val secureLogger = Logger.withFilter(policy)
secureLogger.w("Security", "可疑操作")
所有结果都是标准的
Logger或Filter实例 —— 完全可组合，就像数字一样自由运算。
在共享模块中（build.gradle.kts）：
dependencies {
implementation("io.github.scarlet-pan:logger:1.2.0")
}
自动启用所有平台的日志功能。
implementation("io.github.scarlet-pan:logger-android:1.2.0")
行为与 android.util.Log 完全一致，日志直接显示在 Logcat。
通过 CocoaPods（Podfile）：
pod 'KmpLogger', :git => 'https://github.com/scarlet-pen/logger.git', :tag => '1.2.0'
Kotlin 日志会自动出现在 Xcode 控制台。为获得更符合 Swift 习惯的体验，建议添加 Loggers.swift。
标准 JVM 项目使用：
implementation("io.github.scarlet-pan:logger-jvm:1.2.0")
若使用 SLF4J（如 Spring Boot），推荐桥接版本：
implementation("io.github.scarlet-pan:logger-slf4j:1.2.0")
并在启动时设置 Logger.default = Slf4jLogger()。
⚠️ 基础
logger包仅适用于 KMP 项目。非 KMP 项目请使用平台专属包（如-android、-jvm等）。
🔧 最低要求
- Kotlin ≥ 1.9.0
- Android minSdk ≥ 21
- iOS 部署目标 ≥ 12.0
import dev.scarlet.logger.Logger
Logger.d("Network", "请求已发送")
Logger.i("DB", "查询成功")
Logger.w("Cache", "使用了过期缓存")
Logger.e("Auth", "登录失败", exception)
这段代码在 commonMain、androidMain、jvmMain 或 iosMain 中无需任何修改即可运行。
Kotlin 日志会通过 print 自动出现在 Xcode 控制台。
为获得更符合 Swift 习惯的体验，建议添加 Loggers.swift：
SharedLogger.i("Network", "请求已发送")
SharedLogger.e("Database", "打开失败", error: dbError)
此封装是可选的，但推荐用于生产级 iOS 应用。
import dev.scarlet.logger.DefaultLogger;
DefaultLogger.d("Service", "任务启动");
DefaultLogger.e("DB", "连接丢失", exception);
Logger.d("Debug") { "调试信息：${computeHeavyData()}" }
Logger.w("IO") { "读取失败" with ioException }
Lambda 仅在日志启用时执行 —— 真正零开销。
val debugLogger = Logger.withFilter(Filter.ALL)
debugLogger.d("FeatureX") { "开发专用日志" }
Filter.default = Filter.atLeast(INFO) // DEBUG 日志将被跳过
Logger.default = Logger.SYSTEM + FileLogger("app.log")
val offline = Logger.default - RemoteLogger
val policy = LevelFilter.atLeast(WARN) + TagFilter.include("Security")
val secureLogger = Logger.withFilter(policy)
secureLogger.w("Security", "可疑操作")
所有结果均为标准 Logger 或 Filter 实例，可继续组合。
Logger.d { "昂贵的调试信息" }）| 平台 | 日志后端 |
|---|---|
| Android |
欢迎贡献！详见 CONTRIBUTING.md。
MIT 许可证 —— 详见 LICENSE。
版权所有 © 2025 Scarlet Pan
fun d(tag: String, msg: String, tr: Throwable? = null)
fun i(tag: String, msg: String, tr: Throwable? = null)
fun w(tag: String, msg: String, tr: Throwable? = null)
fun e(tag: String, msg: String, tr: Throwable? = null)
android.util.Log |
| iOS | println() |
| JVM | System.out or SLF4J |
| JS | console.log |
fun d(tag: String, msg: String, tr: Throwable? = null)
fun i(tag: String, msg: String, tr: Throwable? = null)
fun w(tag: String, msg: String, tr: Throwable? = null)
fun e(tag: String, msg: String, tr: Throwable? = null)
android.util.Log |
| iOS | println() |
| JVM | System.out 或 SLF4J |
| JS | console.log |
Surfaced from shared tags and platforms — no rankings paid for.