DebugKit

Additional

Language
Java
Version
N/A
Created
Apr 19, 2017
Updated
Jul 6, 2018 (Retired)
Owner
hulab
Contributor
Pierre-Emmanuel Altieri (Nebneb)
1
Activity
Badge
Generate
Download
Source code

Android DebugKit

DebugKit lib for Android allows you to use a fancy hovering debug tool to trigger some actions directly in the app. This tool is very useful to trigger some event at runtime, and to have a written feedback directly on your testing phone screen.

Requirements

  • Android SDK 15+

Example

You can download an example apk here : DebugKit-Example.apk

Installation

repositories {
    jcenter()
}

dependencies {
    compile 'com.hulab.android:debugkit:1.2.1'
}

Usage

final DevTool.Builder builder = new DevTool.Builder(mContext);

builder.addFunction(new DebugFunction() {
            @Override
            public String call() throws Exception {
                log("doing some stuff...");
                doSomeStuff();
                return "Some stuff was done.";
            }
        }).addFunction(new DebugFunction() {
            @Override
            public String call() throws Exception {
                log("doing some other stuff...");
                doSomeStuff();
                return "Some stuff was done.";
            }
        }).addFunction(new DebugFunction("My function") {
            @Override
            public String call() throws Exception {
                log("doing some stuff again and again...");
                doSomeStuff();
                return "This function has a title!";
            }
        });                
        // This is a prebuilt function to clear the console, you can call clear() in any function
        // as well.
        .addFunction(new DebugFunction.Clear("Clear"))
        // This is a prebuilt function to dump the content of your shared preferences file.
        .addFunction(new DebugFunction.DumpSharedPreferences("Shared prefs", PREFS_FILE_NAME));
 
        // optional, DevToolFragment.DevToolTheme.DARK is set by default
builder.setTheme(DevToolFragment.DevToolTheme.DARK)
        //you can set the initial position of your debug tool (0,0) by default
       .displayAt(100, 100)
       .build();

Result

Here we have 3 debug tools, from top to bottom:

  • LIGHT theme with 5 defined functions
  • Minified mode (clicking on the top left corner arrow)
  • DARK theme with 3 defined functions and the logged text when clicking on each F1, F2 and F3



Have fun!