Skip to content

bartwell/ultra-debugger

Repository files navigation

Ultra Debugger

Ultra Debugger is an open source modules-based android library for application debugging.

Features

Ultra Debugger is module-based tools for easy Android applications debugging. It can be useful for developers and testers. Module-based architecture allow to extend functionality and add specific functionality for your project.

Currently available modules:

  • Reflection - allow call methods from current activity, see list of fields and methods in this activity
  • SQLite - allow see, add, edit and delete items from databases
  • Shared Preferences - allow see, add, edit and delete items from shared preferences
  • Info - shows information about device
  • Logger - Module for logging and variables tracking (use methods Logger.addLog() and Logger.saveValue())
  • Files - allow see directories and download/remove files from device (including application directory)

New modules will added...

Integration

Here is few option to integrate Ultra Debugger in your application.

Add for all configurations

1. Add in build.gradle:

compile 'ru.bartwell:ultradebugger:1.3'

2. Add in Application class in onCreate() method:

UltraDebugger.start(this, 8090);
Add only for debug configurations

1. Add in build.gradle:

debugCompile 'ru.bartwell:ultradebugger:1.3'
compile 'ru.bartwell:ultradebugger.wrapper:1.3'

2. Add in Application class in onCreate() method:

UltraDebuggerWrapper.setEnabled(BuildConfig.DEBUG);
UltraDebuggerWrapper.start(this, 8090);

Default port number is 8080.

Usage

After you integrate library just start application on your smartphone, open browser on your computer and type in address http://xxx.xxx.xxx.xxx:8080, where xxx.xxx.xxx.xxx - IP address of your smartphone. It mean that your computer and smartphone should connected to same network.

How to support project

Your help is really appreciated.

  • Please create your own modules or edit exists and make pull requests
  • Or just click star button on this page.

Modules creation

1. Create Android library project.

2. Add base library as dependency:

compile 'ru.bartwell:ultradebugger.base:1.2'

3. Create class Module extends BaseModule in package ru.bartwell.ultradebugger.module.xxx, where xxx - your module name.

4. Implement methods in your class:

  • String getName() - return human readable your module name from this method
  • String getDescription() - return description of your module
  • HttpResponse handle(HttpRequest) - handle HTTP requests in this method and return result which will sent into browser.

You can use classes Page, Form, Table, etc. which helps to construct HTML code.

Please feel free to see source code of another modules as example.

TODO

  • More modules: Realm, something else
  • Pagination
  • Design improvement for HTML pages
  • Code quality improvements

License

Copyright © 2017 Artem Bazhanov

Ultra Debugger is provided under an Apache 2.0 License.

Ultra Debugger uses NanoHttpd to serve HTTP requests (NanoHttpd Copyright (c) 2012-2013 by Paul S. Hawke, 2001,2005-2013 by Jarno Elonen, 2010 by Konstantinos Togias All rights reserved).

About

Ultra Debugger is an open source modules-based android library for application debugging.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages