Android Logging

The airG android logging library is a group of utilities for easier logging. airG android logger uses android.util.log methods to log so there’s no special sauce and the same log granularity (e, w, d, i, v, etc.) is provided.

For a more complete reference, check out the Javadocs.

Formatted Logging

Formatted messages (see String Formatter documentation for reference) are easier to work with than concatenating bits and pieces of info.

Example

Log.d("LOGTAG", "There are %d items in category '%s'", categoryList.size(), categoryName)

Tagged Logger

Aside from the static methods, there is also a tagged logger which allows you to focus only on the log message itself and not the tag (the little things matter).

Example

public class ContactsActivity extends Activity {
    private final TaggedLogger LOG = Logger.tag("CONTACTS");
    ...
    private void doSomething () {
       LOG.d("Look, Ma! No Hands!");
       // This translates to: Log.d ("CONTACTS", "Look, Ma! No Hands!")
    }
    ...
}

LogCatcher

The LogCatcher class is an experimental bit that can be used to collect logs from the device. It’s a great tool for error reporting. Bits and pieces of this code have been previously used for diagnostic error reporting so while this class is new, the idea is sound and works. The LogCatcher class supports two methods of execution:

Dump

The dump mode is equivalent of running logcat -d. It runs logcat and prints out everything currently in the log and quits.

Capture

The capture mode is for ongoing collection of log entries. You start the capture as well as end it.

Usage

To use the android-logging library in your builds, add the following line to your Gradle build script:

compile 'com.airg.android:logger:+@aar'

Or download the library from the download link at the top of this page.

Contributions

Please refer to the contribution instructions.