Skip to content
/ pandora Public

an android library for debugging what we care about directly in app.

License

Notifications You must be signed in to change notification settings

whataa/pandora

Repository files navigation

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 Release
    pandora-no-op Release
  2. (Optional)If your project use OKHttp as a network library, interceptor can be injected into OKhttp by pandora-plugin Download

    // 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.

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