Android Local Unit Tests

ObjectBox supports local unit tests. This gives you the full ObjectBox functionality for running super fast test directly on your development machine.

On Android, unit tests can either run on an Android device (or emulator), so called instrumented tests, or they can run on your local development machine. Running local unit tests is typically much faster.

To learn how local unit tests for Android work in general have a look at the Android developers documentation on Building Local Unit Tests. Read along to learn how to use ObjectBox in your local unit tests.

Set Up Your Testing Environment

V1.5.0+: The ObjectBox plugin automatically adds the native ObjectBox library required for your current operating system.

Synchronization is coming  GET YOUR EARLY ACCESS

Before V1.5.0: Add the native ObjectBox library to your existing test dependencies in your app’s build.gradle file:

Local unit tests are currently only supported on 64-bit operating systems.

Create a Local Unit Test Class

You create your local unit test class as usual under module-name/src/test/java/. To use ObjectBox in your test methods you need to build a BoxStore instance using the generated MyObjectBox class of your project. You can use the directory(File) method on the BoxStore builder to ensure the test database is stored in a specific folder on your machine. To start with a clean database for each test you can delete the existing database using BoxStore.deleteAllFiles(File).

The following example shows how you could implement a local unit test class that uses ObjectBox:

Hint: To help diagnose issues you can enable log output for ObjectBox actions, such as queries, by specifying one or more debug flags when building BoxStore.

Base class for tests

It’s usually a good idea to extract the setup and tear down methods into a base class for your tests. E.g.:

Testing Entities with Relations

The following is no longer necessary with 1.5 or newer.

To test entities that have relations, like ToOne or ToMany properties, you must modify your entities first. These modifications are normally done by the ObjectBox plugin byte-code transformer. But the transformer does not run for local unit tests (it does for instrumented tests).

For each entity that has relations you need to initialize each ToOne and ToMany field. In addition you need to add a transient BoxStore field named __boxStore.

An example for a modified entity class might look like this:


Next steps

Get the Android Studio objectbox-example project with a full local unit test example.


Spread the love