nextgenintelligence / 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. Also supports inspecting of the sqlite databases created by CouchBase Lite since DbInspector version 1.1.0.

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.

Now you have a launcher icon for viewing you in-app database which appears only on debug builds. You can define @string/dbinspector_app_name to change the launcher icon label and @drawable/dbinspector_ic_launcher to change the launcher icon.

You probably want to define at least @string/dbinspector_app_name in your strings.xml to avoid confusion in case of multiple apps using DbInspector on the same device.

We also maintain a changelog.

Removing launcher icon

If you don't want the launcher icon to be shown, add this to your debug manifest:

<activity
    android:name="im.dino.dbinspector.activities.DbInspectorActivity">
    <intent-filter tools:node="removeAll">
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

Support

As of version 3.0.0, DbInspector can be used with your apps on devices all the way back to Android 2.3 (API 10). It should also work on devices with API 7-9, but that's not tested.

Upgrading 2.x -> 3.x

Remove the DbInspectorActivity declaration from your app manifest, this declaration is now included in the library manifest and it gets merged in with your app manifest during the build process.

Upgrading 1.x -> 2.x

Change the theme set to DbInspectorActivity your app manifest to an AppCompat theme. DbInspectorActivity extends ActionBarActivity since 2.0.0.

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.