Skip to content

Esri/Khronicle

Repository files navigation

Khronicle

An SLF4J backend for Android. It is a from scratch minimal implementation that will allow you to redirect log outputs coming from SLF4J into destinations such as log files or logcat.

It is similar to logback-android, but written in Kotlin from scratch. The advantage for us is that we don't have to depend on another third-party right now, and it would be easy to swap it for a different backend if needed later.

Instructions

  1. Add SLF4J as a dependency, e.g. implementation("org.slf4j:slf4j-api:2.0.16")
  2. Add Khronicle as a dependency
  3. Create a logger-config.xml file in resources/assets/
  4. Use SLF4J to log messages, like you would with any other SLF4J backend

Proguard options

Logging appenders are created via reflection so class names must be left intact for runtime. In order to keep them you will need to add the following to your application proguard rules:

-keep class com.esri.logger.khronicle.appender.** { *; }

Requirements

  • Android SDK 24 or newer.

Resources

Issues

Find a bug or want to request a new feature? Please let us know by submitting an issue.

Contributing

Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.

Licensing

Copyright 2025 Esri

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's LICENSE.txt file.

About

An SLF4J backend for Android, in Kotlin

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors 2

  •  
  •