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.6-1.

Download

• logback-android-1.0.6-1.jar (MD5: bbda40e50904590c52dc81945824daa2)
• 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@qos.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.6-1.jar.