Home

Welcome to the Android-PLog wiki!

Please click links from the right side bar to read what you are interested in.

Steps to use PLog

1.Import via gradle

currently the latest version is

    compile 'org.mym.plog:plog-core:${latestVersion}'

    //IMPORTANT TIPS: the artifactId for 1.x version is `android-plog`. 
    //So if you want to use 1.x version(NOT RECOMMENDED), please import using following dependency:
    //compile 'org.mym.plog:android-plog:1.7.0'

For dependencies of other modules, please click here.

2.Prepare printers (Recommended)

Since you may need to intercept or redirect logs, in PLog 2.x version, we recommend you to prepare printers manually.

//all logs will be automatically disabled on release version
PLog.prepare(new DebugPrinter(BuildConfig.DEBUG));

Don't worry, if you forgot this, your app won't crash. You will just receive a WARNING message on the runtime, then all logs will be print to logcat only.

You can also put your customize configs before printing any logs:

PLog.init(PLogConfig.newBuilder()
        .globalTag("MyApp")
        .forceConcatGlobalTag(true)
        .build());

3.Just enjoy it!

Now you can use PLog class to print log, via v(), d(), i() method, and so on. Sample:

//Empty message    
PLog.empty();

//log with auto tag
PLog.v("This is a verbose log.");
PLog.e("This is an error log.");

//Advanced usage
PLog.level(Log.DEBUG).tag("Scenario").category("RESULT")
    .message("You win!").execute();

For more sample codes please see app module on this repository.