Vlog
Vlog was featured in Android Weekly
An In-Display real-time logging Library for Android.
Vlog provides an easy and convenient way to access logs right on your phone.
Messenger chat like bubble is introduced to display logs in a non-intrusive manner. The bubble also shows the count badge to indicate the presence of logs. Along with that, basic filtering capability helps with finding specific logs,
Philosophy
Logs play a crucial part in diagnosing issues. Without proper logging, developers may have to spend countless hours debugging the root cause. When the codebase becomes huge, logs can also prove to be useful in understanding complex execution flows. Although one can argue to follow execution from one breakpoint to another, the whole process can be time-consuming. But for the most part, logs are an indispensable tool in any developer’s arsenal. More so for an android developer where there can be network failures, device permission denials, SQL errors, background thread issues, telemetry data inaccuracies, and innumerable other concerns. And Vlog takes it a step forward and helps in conveniently check logs right on your phone.
Getting Started
Gradle Dependency
Add maven source in root build.gradle:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
Add the library dependency in build.gradle file. Notice the no-op version, an empty implementation, which ensures library is not added to the release builds:
dependencies {
debugImplementation 'com.github.girish3.Vlog:library:v0.3'
releaseImplementation 'com.github.girish3.Vlog:library-no-op:v0.3'
}
Basic Usage
The Vlog exposes easy-to-use APIs and has same logging methods as Android's Log utility ( Log.v, Log.d...)
val vlog = Vlog.getInstance(context) // In the above code, make sure to pass application context as an argument instead of Activity context // start vlogging (the bubble will appear) vlog.start() vlog.v("" , "" ) // verbose log vlog.e("" , "" ) // error log // stop vlogging vlog.stop() // check if vlog is currently active vlog.isEnabled() // returns true if vlog.start() was called
Integrate with Timber
Timber is a popular logging library. Timber is extensible therefore Vlog can be seamlessly integrated alongside Timber. Add a behavior through Tree instance and plant the instance by calling Timber.plant. For more details, check the timber sample module in this repo.
Advance Usage
Often, there is a need to not just print logs but also either to save them in a local file or upload it to a server. The Chain of responsibility pattern is a recommended pattern for such needs. In this pattern, each object in the chain receives the log data and can therefore be responsible to print the log statement (logcat), save in a file, or, in our use-case, pass the data to Vlog library. Refer sample app in this repo for more details. For a quick setup, the app's logger folder can directly be copy-pasted in any Android project.
Contribute
All types of contribution is accepted. Raise issues, suggest changes or submit a pull request.
675 Nov 14, 2022
457 Jan 7, 2023
2 Jul 13, 2022
9.9k Jan 8, 2023
13.5k Dec 30, 2022
37 Dec 7, 2022
49 Aug 22, 2022
40 Dec 8, 2022
121 Dec 26, 2022
2 Apr 8, 2022
13 Aug 29, 2022
187 Dec 18, 2022
460 Dec 31, 2022
98 Dec 15, 2022
6 Aug 26, 2022
1.1k Jan 5, 2023
198 Nov 15, 2022
28 Oct 3, 2022
187 Dec 18, 2022
6 Aug 26, 2022
1.1k Jan 5, 2023
849 Dec 23, 2022
7.9k Dec 31, 2022
395 Jan 4, 2023
1 Dec 13, 2021
1 Jul 26, 2022
54 Nov 29, 2022
12 Aug 23, 2022