Skip to content

Latest commit

 

History

History
88 lines (62 loc) · 3.12 KB

README.md

File metadata and controls

88 lines (62 loc) · 3.12 KB

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

Download

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

For help with using logback-android, ask the mailing list: [email protected].

Build

logback-android is built with Apache Maven. Use these commands to create the uber JAR.

mvn install 
mvn -f pom-uber.xml package -Dmy.project.version=1.0.7-2-SNAPSHOT

NOTE: The uber jar contains logback-android-core, logback-android-classic, and apktool-lib (repackaged under ch.qos.logback.repackage). The apktool-lib will be optional in a future release.

To include logback-android in your Maven project, add the following dependencies to your project's pom.xml:

<dependency>
  <groupId>com.github.tony19</groupId>
  <artifactId>logback-android-core</artifactId>
  <version>1.0.7-1</version>
</dependency>
<dependency>
  <groupId>com.github.tony19</groupId>
  <artifactId>logback-android-classic</artifactId>
  <version>1.0.7-1</version>
</dependency>