stetho-realm 0

Realm module for Stetho

2 years after BSD-3-Clause

Stetho-Realm

Stetho-Realm is a Realm module for Stetho.

It displays Realm database content in Stetho instead of SQLite database content.

Set-up

Download

grab via Gradle:

repositories {
    maven {
        url 'https://github.com/uPhyca/stetho-realm/raw/master/maven-repo'
    }
}

dependencies {
    compile 'com.facebook.stetho:stetho:1.4.1'
    compile 'com.uphyca:stetho_realm:2.0.0'
}

Stetho-Realm 2.0 supports Stetho 1.1 or newer and Realm 2.0.0 or newer. If you'd like to use Stetho-Realm with Realm 0.80.0 to Realm 1.2.0, please use the latest version of Realm 0.x.

Integration

In your Application class, please initialize Stetho with RealmInspectorModulesProvider.ProviderBuilder as follows.

RealmInspectorModulesProvider.ProviderBuilder replaces SQLite module with Realm module. You can use RealmInspectorModulesProvider.ProviderBuilder#baseProvider(InspectorModulesProvider) in order to customized InspectorModulesProvider instead of default provider.

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();

        Realm.init(this);

        Stetho.initialize(
                Stetho.newInitializerBuilder(this)
                        .enableDumpapp(Stetho.defaultDumperPluginsProvider(this))
                        .enableWebKitInspector(RealmInspectorModulesProvider.builder(this).build())
                        .build());
    }
}

By calling some methods in RealmInspectorModulesProvider.ProviderBuilder, you can include metadata table in table list, and can provide database file name pattern. And also you can specify base folder for database files, encryption keys, limit, sort order.

    RealmInspectorModulesProvider.builder(this)
            .withFolder(getCacheDir())
            .withEncryptionKey("encrypted.realm", key)
            .withMetaTables()
            .withDescendingOrder()
            .withLimit(1000)
            .databaseNamePattern(Pattern.compile(".+\\.realm"))
            .build()

use Stetho in debug build only

http://littlerobots.nl/blog/stetho-for-android-debug-builds-only/

License

Stetho-Realm is BSD-licensed.

TODO

  • coexistence with SQLite module.
  • implementation of update, delete, etc.

deployment memo

  1. update version information
  2. ./gradlew clean assemble :stetho_realm:publishMavenPublicationToMavenRepository
  3. git add, commit, push (on master branch)

Related Repositories

awesome-android

awesome-android

A curated list of awesome Android packages and resources. ...

android-proguard-snippets

android-proguard-snippets

Proguard configurations for common Android libraries ...

awesome-android-cn

awesome-android-cn

Android 资源大全中文版,包括:图表、游戏开发、GUI、崩溃检测、调试工具等,由伯乐在线持续更新。 ...

android-proguards

android-proguards

AAR proguards ...

android-dev-sources

android-dev-sources

All those android development sources that you need to be and stay awesome! ...


Top Contributors

zaki50 jenzz iflatness esmasui

Releases

-   v2.0.0 zip tar