ObjectBox Admin
The ObjectBox Admin web app (formerly Data Browser) is an easy way to view what's happening in your database of your app using a web browser. Browse your app's data and gain insights.
ObjectBox Admin Web App
Works for Android apps built with ObjectBox for Java or Flutter
The ObjectBox Admin web app (formerly known as ObjectBox Data Browser) allows you to
- view the Objects and schema of your database inside a regular web browser,
- and download Objects in JSON format.
The Admin web app runs directly on your device or on your development machine. Behind the scenes this works by bundling a simple HTTP server into ObjectBox when building your app. If triggered, it will then provide a basic web interface to the data and schema in your store.
The Data Browser web app.
Setup
We strongly recommend using Admin only for debug builds as it ships with additional resources and configuration not intended for production code.
Java
Flutter
Modify the app's Gradle build file to add the dependency and change the “io.objectbox” plugin to be applied after the dependencies block:
app/build.gradle
1
dependencies {
2
// Manually add objectbox-android-objectbrowser only for debug builds,
3
// and objectbox-android for release builds.
4
debugImplementation("io.objectbox:objectbox-android-objectbrowser:$objectboxVersion")
5
releaseImplementation("io.objectbox:objectbox-android:$objectboxVersion")
6
}
7
8
// Apply the plugin after the dependencies block so it picks up
9
// and does not add objectbox-android.
10
apply plugin: 'io.objectbox'
11
// Or using Kotlin DSL:
12
apply(plugin = "io.objectbox")
Copied!
If the plugin is not applied afterwards, the build will fail with a duplicate files error (like
Duplicate files copied in APK lib/armeabi-v7a/libobjectbox.so) because the plugin fails to detect and adds the objectbox-android library.Modify the Gradle build file of the Flutter Android app to add the dependency:
android/app/build.gradle
1
// Tell Gradle to exclude the objectbox-android dependency
2
// that is added by objectbox_flutter_libs for debug builds.
3
configurations {
4
debugImplementation {
5
exclude group: 'io.objectbox', module: 'objectbox-android'
6
}
7
}
8
9
dependencies {
10
// Add objectbox-android-objectbrowser only for debug builds.
11
// Warning: when objectbox_flutter_libs updates check if version
12
// needs update, e.g. check https://github.com/objectbox/objectbox-dart/releases.
13
debugImplementation("io.objectbox:objectbox-android-objectbrowser:<version>")
14
}
Copied!
Finally, after creating the store, to start Admin:
Java
Flutter
Create an
AndroidObjectBrowser instance and call start:1
boxStore = MyObjectBox.builder().androidContext(this).build();
2
if (BuildConfig.DEBUG) {
3
boolean started = new Admin(boxStore).start(this);
4
Log.i("ObjectBoxAdmin", "Started: " + started);
5
}
Copied!
Create an
Admin instance and keep a reference, optionally close it once done using the web app:1
if (Admin.isAvailable()) {
2
// Keep a reference until no longer needed or manually closed.
3
admin = Admin(store);
4
}
5
6
// (Optional) Close at some later point.
7
admin.close();
Copied!
Info: added Android manifest permissions
Browse data on your device
When Admin is created/started it will print the URL where to access the web app to the logs, e.g. something like:
http://localhost:8090/index.htmlThis URL can be opened on the device or emulator. To open the web app on your dev machine, see the instructions below.
For ObjectBox for Java, the app also displays a notification to access Admin. Tapping it will launch a service to keep the app alive and opens the Admin web app in the web browser on the device.
Stop the keep-alive service from the notification.
Browse data on your dev machine
To open the web app on your development machine check the log output when launching the app. Note the port of the URL:
1
ObjectBrowser started: http://localhost:8090/index.html
Copied!
If available, like here, port 8090 is used. On your dev machine, use the ADB command to forward the port (or whichever you like) to that port of your device:
1
adb forward tcp:8090 tcp:8090
Copied!
Then open the web app URL in a web browser on your dev machine.
Download Objects
When viewing Objects tap the download button at the very bottom. This will download the Objects formatted as JSON.
The download option for objects.
Last modified 5d ago
Export as PDF
Copy link