fritexvz / android_dbinspector

Android library for viewing in app databases.

Android DbInspector

Provides a simple way to view the contents of the in-app database for debugging purposes. No need to pull the database from a rooted phone.

Usage

Add the library as a dependency to your build.gradle

debugCompile 'im.dino:dbinspector:(insert latest version)@aar'

Check the latest version on Maven Central.

Declare DbInspectorActivity in your debug manifest (src/debug/AndroidManifest.xml)

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application>
        <activity
            android:name="im.dino.dbinspector.activities.DbInspectorActivity"
            android:label="Example DbInspector"
            android:icon="@drawable/ic_launcher_dbinspector">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

Now you have a launcher icon for viewing you in-app database which appears only on debug builds.

Support

DbInspector needs minSdk 14 to run, but it declares minSdk 7 so you can include it in your project which may support pre-ICS devices.

Note

By default, when you run the app from Android Studio it will launch DbInspectorActivity. You can override this behaviour by editing the run configurations, at the top next to the run button and selecting your apps entry activity.

Contributing

Feedback and code contributions are very much welcome. Just make a pull request with a short description of your changes. By making contributions to this project you give permission for your code to be used under the same license.