---

This project has moved to qos-ch/logback-android
and will be deleted May 9, 2012.

---

logback-android

Advanced logging library for Android applications

Overview

Logback-Android brings the power of Logback to Android. Logback is a reliable, generic, fast, and flexible logging library for Java applications.

The current version is 1.0.1-1.

Download

• logback-android-1.0.1-1.jar (MD5: bd7110d7cc6b0138f280f73ca37092a6)
• slf4j-api-1.6.4.jar (MD5: a134d83e0c12a9611824284c855ffb13)

Quickstart

1. Add Logback and SLF4J to your project classpath.

2. Enter configuration XML in one of the following locations. Note that Logback-Android checks them in exact order and uses the first one found.

   • SD card (/sdcard/logback/logback.xml)
   • Your application's AndroidManifest.xml
   • Your application's assets/logback.xml (create dir if necessary)

   If not found, a simple LogcatAppender is used by default.

3. Ready to run!

See examples

Features Supported

Runs on Android 2.1+

Logback-Android supports only a subset of Logback's features (i.e., the logback-core and logback-classic modules). It does NOT support the following:

• logback-access
• Groovy configuration
• Conditionals in the configuration XML
• JMS, JMX, JNDI, and Servlets

Documentation

• Logback-Android Javadoc
• Logback manual
• Why switch from log4j?
• Changelog

For help with using Logback-Android, ask the mailing list: logback-user AT qos DOT ch.

Build

Logback-Android is built from Ant, using the Android SDK.

1. Download the Android SDK, Revision 14 (or newer).
2. Change directory to ${logback-android-src}/build/ant.
3. Edit ant.properties:
   • Set sdk.dir to the root directory of the Android SDK.
   • Set slf4j.jar to the path of SLF4J API library.
4. Enter ant to begin the build. The JAR is created at bin/logback-android-1.0.1-1.jar.