whataa/pandora

EN | 中文

Pandora is a tool box that allows you to inspect and modify what includes networks, databases, UIs, etc. directly in your application. It is suitable for rapid position of various problems in the development and testing stages.

Demo

Feature

Network logs

• Check the detailed logs of network requests, such as headers, body, error messages, and so on.
• Support all network libraries based on OKHTTP and Android native HttpURLConnection, covering most network development situations.

Sandbox

• View the app's private storage directory, and can export files to SDcard.
• Supports browsing and editing SQLite databases, SharedPref files.

UI：Select、Hierarchy、Baseline、Gridline

• View and modify properties of any Widget, such as the widget's size, color, text content, and so on.
• Grab and move any widget, view the boundaries and relative distance between widgets, detect alignment, layout and other issues.
• View the hierarchy of any UI, support Activity, Dialog, PopupWindow, etc.

Other tools

• Show the current Activity in real time.
• Supports recording crash, compatible with third-party Crash libraries.
• You can add shortcut to Pandora.
• You can open any Activity of your app.
• You can view the lifecycle history of Activities.

Usage

1. Declare Jitpack repository and add dependencies：

   // android-support
   debugImplementation 'com.github.whataa:pandora:v${RELEASE}'
   // or androidX
   debugImplementation 'com.github.whataa:pandora:androidx_v${RELEASE}'
   
   // No matter android-support or AndroidX
   releaseImplementation 'com.github.whataa:pandora-no-op:v${RELEASE}'
   

   library	version
   pandora
   pandora-no-op

2. （Optional）If your project use OKHttp as a network library, interceptor can be injected into OKhttp by pandora-plugin ：

   // in your project's gradle
   buildscript {
       dependencies {
           ...
           classpath 'com.github.whataa:pandora-plugin:1.0.0'
       }
   }
   
   // in your app's gradle
   apply plugin: 'com.android.application'
   apply plugin: 'pandora-plugin'
   

3. Grant permission to "Overlay Windows" and shake your device.

Feature APIs and Problems

Thanks

Pandora was developed on the shoulders of giants. Thanks to the following open source projects or person:

• Logo and Icon are produced by the designer Zularizal.

• Inspired by Flipboard's open source iOS platform debugging tool FLEX；

• Project database module ideas and part of the source code from Facebook's open source project stetho；

• The idea of selecting views in the UI module of the project and part of the source code from eleme's open source project UETool；

• The request API in the Demo module comes from jgilfelt's open source project chuck ；

License

Apache-2.0