whataa/pandora

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

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.whataa:pandora:2.1.0'
	}

	dependencies {
		implementation("com.github.whataa:pandora:2.1.0")
	}

	<dependency>
	    <groupId>com.github.whataa</groupId>
	    <artifactId>pandora</artifactId>
	    <version>2.1.0</version>
	</dependency>


                            
    libraryDependencies += "com.github.whataa" % "pandora" % "2.1.0"


                            
    :dependencies [[com.github.whataa/pandora "2.1.0"]]

Readme

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

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 |

（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'

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